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How to Use This Manual 

The RT-11 software kit contains four generic operating systems that are 
designed to meet the needs of most RT-11 users. However, you need not be 
hmited to the use of any one of these systems if they do not meet your 
needs. This manual provides you with the information you need to generate 
a system tailored to your specific needs. Chapter 1 describes the system 
generation procedure that you must follow and specific questions you must 
answer to generate your particular system. Chapter 2 tells you how to run 
the SYSGEN program to build the resulting system. Chapter 3 describes 
system generation on a dual-diskette system. However, DIGITAL does not 
recommend a system generation of this kind. 

Additional information available in the appendixes includes: system gener- 
ation answers that duplicate the standard, distributed monitors, system 
generation answers that create an example multiterminal system, RT-11 
conditionals, and customizations required for specially generated monitors. 

Before you begin, you should read the Guide to RT-11 Documentation, 
which describes the other software documents associated with the RT-11 
operating system. Familiarity with the RT-11 system, as described in the 
RT-11 System User's Guide, RT-11 System Utilities Manual, and Chapter 
1 of the RT-11 Installation Guide, is particularly helpful when you perform 
the procedures in this manual. 

If you are a FORTRAN IV, BASIC-11, CTS-300, or other layered product 
user, you build your FORTRAN IV, BASIC-11, FMS-11, CTS-300, or other 
system after building the RT-11 system. A layered product is software that 
is sold separately but requires the RT— 11 oneratinc s""^stem environment to 
run. See the appropriate installation manual for instructions on installing 
such products. 



Vll 



Documentation Conventions 

You should become familiar with certain symbolic conventions used in this 
manual. 

1. Examples consist of actual computer output whenever possible. In these 
examples, user input appears in red where it must be differentiated 
from computer output. 

2. Unless the manual indicates otherwise, all commands or command 
strings end with a carriage return. The symbol (HS) represents a car- 
riage return, © a line feed, IB a space, (HE) an ESCAPB:or ALTMODE, 
and ® a tab. 

3. To produce certain characters in system commands, you must type a 
combination of keys concurrently. For example, while holding down the 
CTRL key, type C to produce th e CTR L/C character. Key combinations 
such as this are documented as [ctrl/c1 , [ctrl/o] , and so forth. 

4. In descriptions of command syntax, capital letters represent the cbtti- 
mand name, which you must type. Lowercase letters represent a varia- 
ble for which you must supply a value. 

5. In examples, you must distinguish between the capital letter O and the 
number 0. Examples in this manual represent these characters as fol- 
lows: 

Letter O: 

Number 0: 

6. The sample terminal dialog in this manual contains version numbers 
where they would normally appear. The version numbers include xx in 
those fields that can vary from installation to installation. The exact 
contents of these fields are not of interest in the examples in this man- 
ual, as long as appropriate digits appear in the indicated area. The 
same is true for the FREE BLOCKS messages included in device direc- 
tories. 

If you submit a software performance report (SPR) to DIGITAL, you 
must include the complete version number. 

7. A decimal point (.) follows a number to indicate that it is a decimal 
number. A number without a decimal point is an octal number. For 
example, 128. is 128 (decimal) and 126 is 126 (octal). 



Vlll 



Chapter 1 

Preparing for System Generation 



You can build a unique RT-11 monitor through the system generation 
process; however, the procedure requires some preparation. Because the 
procedure lets you set the parameters for the system you want, you should 
be knowledgeable about the process and also prepared with the information 
and selections you will be called on to provide. 

System generation can be either an interactive or an automated procedure. 
You must run the program SYSGEN.COM through the IND processor and 
supply answers to the questions it asks. Answers can be supplied interac- 
tively through the console or automatically through an answer file. To 
complete the process, you will have to assemble and link one or more moni- 
tors and device handlers that will then reflect the parameters you set. 

The system generation process requires a significant amount of mass stor- 
age space and execution time. DIGITAL has distributed four standard mon- 
itors in the distribution kit and recommends that you undertake the system 
generation process only if none of these standard monitors fully meets your 
needs. 

Before beginning the system generation process, you should: 

1. Successfully install and test your working system. 

2. Determine whether the features you need are available only through 
system generation. (Read Chapter 1 of the RT-11 Installation Guide to 
assess whether or not you need to perform a system generation.) 

.^- ReCflTTie fpimiliar with the RT— 1 1 Hnr-nrnontati"" min-n0 ar\an\t^^ pf+<in. 

tion to the RT-11 System User's Guide and RT-11 System Utilities 
Manual, and to Chapter 1 of the RT-11 Installation Guide. 

4. Become comfortable with the keyboard monitor commands and RT-11 
operating characteristics. 

5. Read the installation guide for any layered products you have. (Some of 
these products require specific answers to SYSGEN questions.) 
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You should not attempt to perform the system generation process unless 
your hardware configuration meets certain requirements. 

DIGITAL supports automatic system generation (under license) only on a 
system with at least 16K words of memory and 2000 contiguous free blocks 
of disk storage. The minimum configuration that DIGITAL recommends for 
system generation is a system with at least two disk drives and 24K words 
of memory. 

DIGITAL also supports system generation on RXOl and RX02 diskette sys- 
tems (with at least 28K words of memory), and Professional 325 computers, 
provided you use the manual procedure described in Chapter 3. However, 
DIGITAL does not recommend this very lengthy method. 

To prepare for system generation, you should: 

1. Study the system generation process (Section 1-1). 

2. Gather the information or make decisions described in Section 1.2. 

3. Study the SYSGEN dialog (Section 1-3). 

You can use the worksheet at the end of this chapter (Figure 1-6) to record 
information, decisions, and choices. 

1.1 System Generation Process 

Once you have gathered some information about your configuration, you 
can run SYSGEN and answer the system generation questions to set the 
parameters for your special system. The command to run the system gener- 
ation process is: 

.RUN IND.SAV SYSGEN.COM 

IND.SAV is an indirect control file processor that uses the input file SYS- 
GEN. COM to drive the system generation process. (Both file type specifica- 
tions, .SAV and .COM, may be omitted.) However, if the command SET 
KMON IND was previously issued, you can use the indirect command 

(SSYSGEN. 

The questions that you are asked are in the form of a dialog. SYS- 
GEN.COM contains the dialog and the monitor conditionals. It contains 
IND directives to display explanatory text, query for options, open input 
and output files, test the validity of responses, test and modify conditions, 
and set values for variables. Executing SYSGEN.COM produces the follow- 
ing default output files: 

® SYSGEN.CND 
® SYSGEN.TBL 
« SYSGEN.BLD 
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^ SYSGEN.MON 
® SYSGEN.DEV 
® SYSGEN.ANS 

SYSGEN allows you to choose your own names for them. Your responses to 
the dialog establish the conditionals that SYSGEN writes to the condi- 
tional file SYSGEN.CND. SYSGEN uses some of the conditionals that it 
generates to create SYSGEN.TBL, another conditional file that sets up 
device table entries for each device you specify and defines device handlers. 
SYSGEN.TBL is included in the assembly and link procedures for all gen- 
erated monitors. (For a list of RT-11 conditionals, refer to Appendix C.) 

SYSGEN also creates three indirect command files: SYSGEN.BLD, SYS- 
GEN.MON, and SYSGEN.DEV. These files contain all the command 
strings that perform the assemblies and links that build the system you 
specify when you answer the dialog questions. SYSGEN.MON builds the 
monitor or monitors you define; SYSGEN.DEV builds the device handlers 
you define. SYSGEN.BLD executes SYSGEN.MON and SYSGEN.DEV. 

SYSGEN.COM optionally creates a user-defined answer file, named SYS- 
GEN.ANS by default. This file reflects all responses made during the sys- 
tem generation session, and can be used as input during a later system 
generation session to generate a new monitor without running the entire 
system generation dialog. When an answer file is used, SYSGEN does not 
ask the dialog questions; rather, it gets all the necessary inform-ation for 
the attributes of the system to be generated from the answer file. After 
executing the file, SYSGEN allows you to alter the output file to reflect any 
changes you wish to make, for example, to add monitor options, to support 
additional peripheral devices, or to change device addresses. 

Ultimately, you must assemble and link the SYSGEN.CND, SYS- 
GEN.TBL, and (optionally) TRMTBL.MAC conditional files with certain 
system source files, depending on options you choose during system genera- 
tion. For example, you would need RMONSJ.MAC, the SJ resident monitor 
source file, if your desired system included the SJ monitor. The conditional 
file TRMTBL.MAC, which is distributed with your system software, is re- 
quired only if you are building a multiterminal system. The source file 
EDTGBL.MAC is always required, because it contains system-wide defini- 
tions. 

Once you have answered the SYSGEN questions, copy the system source 
files you need (SYSGEN.CND and SYSGEN.TBL) to the volume that the 
command files use as the source input device. Then assemble and link the 
sources with the conditional files (using SYSGEN.BLD alone or, if you 
wish, SYSGEN.MON and SYSGEN.DEV). You can enter the commands 
individually if you choose. 

Figure 1-1 shows the procedures involved in the system generation process; 
Figure 1-2 shows the files required for system generation. 
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Figure 1-1: System Generation Process 
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Figure 1-2: SYSGEN Input and Output Files 
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1.2 Gathering Information 



To answer SYSGEN dialog questions, you must be familiar with both the 
target system configuration (that is, the one you are generating) and your 
current configuration (that is, the one on which you will run SYSGEN and 
assemble and link the new monitor or monitors and handlers). You should 
also know which monitor services you want in the target system and which 
vector and control status register (CSR) addresses are involved. You will be 
unable to perform the system build process unless you know your current 
configuration and its capabilities, you have planned an optimal file ar- 
rangement for system build on your configuration, and you have answered 
the relevant SYSGEN dialog questions appropriately. In addition, you may 
have to edit the conditional files before you build the target system. To 
make sure that you have all the information you need, identify the follow- 
ing: 

1. Peripheral devices to be supported in the special system you are gener- 
ating (that is, the target system) 

2. Interrupt vector and CSR addresses for devices in the target system 

3. Monitor services you require for the target system 

4. Edits you may need to make to the conditional files 

5. Device assignments for the system build procedure 

The following sections describe how to identify these items. 

1.2.1 Peripheral Devices 

Identify all the peripheral devices that your target system configuration 
will include. List the device mnemonic for each device on the worksheet at 
the end of this chapter (for example, DY for an RX02 diskette). 

NOTE 

You may need to include some empty device slots to make 
sure that your system has enough device slots for your appli- 
cation's requirements. The number of logical device assign- 
ments you will be able to make in the working system is 
equal to the number of device slots available in the system. 

i.£..A iiii«;rrufjii veu;iiurs ana i^snS 

Identify the interrupt vector addresses and CSR addresses at which the 
field service technician installed each peripheral in your configuration. 
When installing the hardware, the field service technician is responsible 
for leaving a written record of this address information at your site, usually 
on a sticker attached to the processor. List each address on the worksheet 
(Figure 1-6). 
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Although most peripherals have standard interrupt vector and CSR ad- 
dresses, some have floating addresses. The presence or absence of such 
floating address devices affects the addresses at which the other floating 
address devices in the system are installed. (Floating address devices must 
be installed in a standard sequence.) Even devices with standard vectors 
may have been installed at nonstandard addresses. 

1.2.3 Monitor Services for Target Application 

DIGITAL has generated the standard monitors through the system genera- 
tion process; you will probably need to select support for features that 
standard monitors also support. In other words, many SYSGEN questions 
offer features you will recognize as standard features in the distributed 
monitors. Table 1—1 summarizes special features that are available only 
through the system generation process. 

Table 1-1: Features Available Only Through System Generation 
Process 



Feature 



Function 



Asynchronous 
terminal status 

BATCH 



Device I/O 
timeout 

Disable .FETCH 
request under 
XM 

Double- 
density 
only RX02 

DZll up to 
9600 baud 

Error logging 



Extra device 
slots 

Global SCCA 



Provides a program with the updated status of terminals in 
multiterminal systems. MU BASIC-11 require this support. 

Allows RT-11 to operate unattended. All monitors except BL 
support BATCH. 

Permits device handlers to issue a mark-time programmed 
request. DECnet applications require this support. 

Disables the use of the .FETCH request under XM, requiring 
device handlers to be resident in memory. 

Permits you to use only double-density RX02 diskettes on the 
system. This feature makes the RX02 handler smaller. 

Permits you to initialize lines at specific baud rates up to 
9600. 

Keeps a statistical record of device, memory parity, and mem- 
ory cache errors. An error logging job is created when you 
select this support for FB; a handler is created for SJ. The EL 
job retrieves information that is later available to you in sum- 
mary report format. 

Permits you to add devices to the system after it is built. The 
number of logical assignments you can make is equal to the 
number of devices plus empty device slots in the system. 

When global SCCA is turned on (enabled), all CTRL/C charac- 
ters sent from the terminal to the background are ignored, 
protecting the program from being aborted with double 
CTRL/Cs. Support must be chosen to use IND directives .EN- 
ABLE ABORT and .DISABLE ABORT. 



(continued on next page) 
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Table 1-1: Features Available Only Through System Generation 

Process (Cont.) 



Feature 



Function 



High-speed 
ring buffer 



Keyboard 
monitor 
command 
subsets 

Memory parity 



Month and year 
rollover 



Multiterminal 
support 

Multiterminal 
timeout 



Programmable 
clock as 
system clock 

Ring buffer 
size 



Second RXOl, 
RX02, or TU58 
controller 

SJ message 
on system 
I/O errors 

SJ timer 



Causes character processing, and interpretation to be per- 
formed at fork level. This allows short bursts of characters 
transmitted at very high rates to be received. Use of this fea- 
ture is recommended with PDTs. 

Allows you to choose one, two, or three subsets of the keyboard 
monitor commands instead of all the commands. 



Causes the system to print an error message when a memory 
parity error occurs if your configuration includes memory par- 
ity hardware. If you have this hardware but do not select this 
support, the system halts when memory errors occur. 

Adds support that automatically rolls over the date at the end 
of the month and the end of the year. Normally, you must 
reset the date and time. This support is useful for applications 
that run continuously and over a long period of time. 

Permits you to use two or more terminals with the SJ, FB, or 
XM monitor. MU BASIC-11 requires this support. 

Causes the monitor to reset at regular intervals any terminal 
that goes off line. This support minimizes the impact of static 
in multiterminal systems. MU BASIC-11 requires this sup- 
port. 

Allows you to substitute as the system clock the KWll-P pro- 
grammable clock for the usual line clock. However, the pro- 
grammable clock would not then be available for program use. 

Allows you to change the size of the input and output ring 
buffers. The input ring is a buffer in the monitor that holds 
characters you type at a terminal until a program requests 
them. The output ring is a buffer in the monitor that holds 
characters until the terminal can print them. The default in- 
put ring buffer size is 134 (decimal) characters, and the de- 
fault output ring buffer size is 40 (decimal) characters. 

Adds support for a second RXOl, RX02, or TU58 RX02, or 
TU58 controller, allowing a total of four units in the configu- 
ration instead of the usual two. 

Causes the SJ monitor to issue an error message instead of 
simply halting. This feature helps to reduce confusion when 
an error occurs. The FB and XM monitors always issue error 
messages. 

Configures the SJ monitor to support mark-time and cancel 
mark-time programmed requests. Otherwise, only the FB and 
XM monitors support these requests, which provide timer ca- 
pabilities. 



(continued on next page) 
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Table 1-1: Features Available Only Through System Generation 
Process (Cont.) 

Feature Function 

.SPCPS Changes the flow of control of main-line code by saving the PC 

programmed and PS and changing the main-line PC to a new value. This 

request support can be generated for only the FB and XM monitors. 

.SPCPS is especially useful for controlling switching among 

users in multiuser applications. 

System jobs Assembles the FB monitor to support as many as eight simul- 

taneously active jobs instead of the usual two. The error log- 
ging subsystem, SPOOL, VTCOM, and the device queue pro- 
gram (QUEUE) can run as system jobs. This feature is avail- 
able in the distributed XM monitor. 

User command Permits users to create their own commands, 

linkage 

Every SYSGEN dialog question is a SYSGEN option. Some options enable 
support for monitor services, w^hile other options enable support for periph- 
eral devices and device interfaces. The options that enable monitor services 
are as follows: 

Asynchronous terminal status 

BATCH support 

Device timeout support 

Error logging support 

Error messages on system I/O errors 

.FETCH request 

Floating point support 

Global .SCCA support 

50 Hz clock rather than 60 Hz 

High-speed ring buffer 

Input ring buffer size 

Keyboard monitor command subsets 

Memory parity 

Month and year date rollover 

Multiterminal support 

Multiterminal timeout 

Output ring buffer size 
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Power failure message 

Programmable clock as system clock 

SJ timer support 

.SPCPS programmed request 

Start-up indirect command file 

System jobs 

User command linkage 

Section 1.3 describes each dialog question in detail. When you study the 
dialog, check off on the worksheet any options you want to select when you 
actually run SYSGEN. 

1.2.4 Defining Other System Conditionals 

Some system conditionals are not set as a result of the system generation 
dialog. For example, there is no system generation question that asks if you 
want idle-loop light support; therefore, the LIGH$T conditional is not set by 
a response to a system generation question. However, the system genera- 
tion dialog lets you define these system conditionals during the system 
generation session. This feature prevents you from ever having to edit a 
system generation .ANS or .CND file, since the definitions will be included 
in both files. 

Questions 68 and 69 of the system generation dialog let you define system 
conditionals. Appendix C contains a list of the system conditionals you can 
define. The following is an example of the procedure. 

E B 1 Do you want to define any other system conditionals ( N ) ? 

If you have no system conditionals to define, respond NO. 

Respond YES if you want to define other system conditionals. The dialog 
then prompts you to define the conditionals: 

B 9 . Enter the s y s t e w conditional and value; 

Type the conditional and value in this format: 
CONDITIONAL = VALUE 

Press RETURN after defining each conditional. For example, the following 
definition enables idle-loop light support. 

LIGH$T = Id!) 

Type a question mark (?) to list all the conditionals you have defined in this 
manner. Type a period (.) followed by a carriage return when you are 
through defining conditionals. 
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1.2.5 System Build Procedure 

The system build procedure requires that you assemble and link your gen- 
erated monitors and handlers but not the utility programs or other nonex- 
ecutive system components. The SYSGEN program produces indirect com- 
mand files that issue all the commands to perform these assemblies and 
links. However, if your only mass storage device is an RXOl or RX02 disk- 
ette, or you are performing a system generation on a Professional 325 sys- 
tem, you may have insufficient free storage space to use indirect command 
files. You will need to issue individual commands to perform the same 
system build procedures. (Refer to Chapter 3.) 

The following sections describe both system build procedures, so that you 
can plan the method you will use and answer the SYSGEN dialog questions 
relative to the indirect command files. 

NOTE 

Once you have created the conditional files SYSGEN.CND 
and SYSGEN.TBL, you can use them over and over without 
rerunning the SYSGEN program. To add source customiza- 
tions to your generated system, simply use the SLP utility to 
customize your system. Then, reassemble those files, and re- 
link the system. 

1.2.5.1 Automatic System Build — At the end of the system generation 
process, the SYSGEN dialog asks you to identify the devices that the indi- 
rect command files should use for input, binary output, and map output 
during the assembly and link processes. When you answer the dialog ques- 
tions and SYSGEN completes, SYSGEN has tailored the indirect command 
files, so that they make the logical assignments SRC:, BIN:, and MAP: 
according to your instructions. The command files then expect to find the 
correct files on each device. Therefore, before you answer these questions, 
you must know which files you want and how much free space you need for 
the build procedure. Then you must plan the organization of files so that 
you can choose the appropriate devices for SRC:, BIN:, and MAP:. Figures 
1-3 through 1-5 illustrate examples of such organization. 

NOTE 

If you answer NO to the SYSGEN question "Do you want to 
retain the system OBJs?", the indirect command files include 

rJcilo'f ir»n /»nirv»TV» o-nrio i-r\ t^c^rm rk-xra 4-l-»o /~^T3 T -Til/^rt 

\^^^±^^U1.'WXX \J\J'XXXJLXXt^X±\JLtJ OU* X\^XXX\JVX^ tjXX\^ tV^JLJ'CJ' XXXC70* 

In most cases, you can use the indirect command files to build your system, 
but you may want to make minor alterations to the command files them- 
selves. For example, you might need to change the devices on which indi- 
vidual source or binary files reside to optimize mass storage usage. 

Study the following paragraphs, which categorize requirements by device. 
Then organize files on volumes according to the: 
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® Hardware you have available 

® Free storage you have 

® Storage requirements for building each component 

If possible, you will want to use the largest and fastest storage devices 
included in your configuration. 

System Device 

When you perform the system build procedures, you must run RT-11 from 
a system device that contains at least the following: 

Monitor 

System device handler 

SWAP.SYS 

Handlers for SRC:, BIN:, and MAP: 

MACRO 

LINK 

PIP 

SYSMAC.SML 

During the build procedure, the default (DK) device needs as many as 128 
free blocks to accommodate the work file MACRO uses during system as- 
sembly. 

Source Input Device 

The source input device must contain the files SYSGEN.CND and SYS- 
GEN.TBL, which are the conditional files that result from a SYSGEN ses- 
sion, and TRMTBL.MAC, which is required only if you plan multiterminal 
support. In addition, the source device must include the system source files 
to build the system you are generating. 

The system source files are included in the distribution kit, but you proba- 
bly did not include them in your working system. You will need to copy the 
appropriate source files from your customized distribution backup vol- 
ume(s). Establish which source files you need by using Table 1-2, and write 
the file names on the worksheet. 



Table 1-2: Source Files Required for System Build 



Source 




File 


To Build Support F 


BA.MAC 


BATCH 


BSTRAP.MAC 


All monitors 


CR.MAC 


Card reader 


CT.MAC 


TAll cassette 


DD.MAC 


DECtape II cartridge 


DL.MAC 


RLOl/02 disk 


DM.MAC 


RK06/07 disk 


DP.MAC 


RP11/RPR02/RP03 



(continued on next page) 
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Table 1-2: Source Files Required for System Build (Cont.) 



Source 




File 


To Build Support For 


DS.MAC 


RJS03/04 disk 


DT.MAC 


DECtape 


DU.MAC 


MSCP-class devices 


DW.MAC 


RD50/RD51 disk (Professional series) 


DX.MAC 


RXOl diskette 


DY.MAC 


RX02 diskette 


DZ.MAC 


RX50 diskette (Professional series) 


EDTGBL.MAC 


All monitors 


EL.MAC 


Error logging 


ELCOPY.MAC 


Error logging 


ELINIT.MAC 


Error logging 


ELTASK.MAC 


Error logging 


ERRTXT.MAC 


Error logging 


FB.MAC 


FB monitor 


FSM.MAC 


File-structured magtape 


KMON.MAC 


All monitors 


KMOVLY.MAC 


All monitors 


LD.MAC 


Logical disk subsetting 


LP.MAC 


Line printer 


LS.MAC 


Serial line printer 


MTTEMT.MAC 


Multiterminals 


MTTINT.MAC 


Multiterminals 


NL.MAC 


Null handler 


PC.MAC 


High-speed paper tape 


PD.MAC 


PDT-11 series 


RF.MAC 


RFll disk 


RK.MAC 


RK05 disk 


RMONFB.MAC 


FB or XM monitor 


RMONSJ.MAC 


SJ monitor 


SJ.MAC 


SJ monitor 


SP.MAC 


Transparent spooling 


SYSGEN.CND* 


All monitors and devices 


SYSGEN.TBL* 


All devices 


TJ.MAC 


TJU16 magtape 


TM.MA.C 


TMll magtape 


TRMTBL.MAC 


Multiterminals 


TS.MAC 


TS11,TU80/TSV05 (UNIBUS/Q-BUS) 




magtape 


'rr.MAC 


SJ monitor 


USR.MAC 


All monitors 


VM.MAC 


Virtual memory "disk" 


XC.MAC 


VTCOM communication for Professional 300 




series 


XL.MAC 


VTCOM communication 


XM.MAC 


XM monitor 


XMSUBS.MAC 


XM monitor 



* Or specified file name. 



1-12 Preparing for System Generation 



Binary Output Device 

The binary output device receives the object files created by the assembly 
process. Identify all the components you must build, that is, all the moni- 
tors and device handlers for which your SYSGEN answers are intended. 
Then refer to Table 1-3 to establish how much free storage you will need on 
the binary output device to build each of these components. 

Table 1-3: Free Storage Required to Build Components 



Component 



Number of 
Blocks 



Monitor 

Device handler 

Set of monitor object modules retained 

Set of handler object modules retained 



300 

11 

200 

8 



When a device is initialized, some space is used for the boot and directory 
blocks. Table 1-4 shows the number of free blocks remaining on various 
devices, after being initialized. 

Table 1-4: Free Blocks on Devices After Initialization 





Device 


Size in 


Device 


Name 


Blocks 


RXOl diskette 


DX 


486 


RX02 diskette 


DY 


974 


RK05 disk 


RK 


4.8K 


RLOl/02 disk 


DL 


10.2/20.4K 


RK06/07 disk 


DM 


27.1/53.7K 


RX50 diskette 


DU,DZ 


786 


RD50 disk 


DW 


9.7K 


RD51 disk 


DU 


19.6K 


RC25 disk 


DU 


43K (approximate) 


RA80 disk 


DU 


220K (approximate) 


Virtual memory 


VM 


Variable, depending 
on physical memory 
available 


Logical disk 


LD 


Variable 



Map Output Device 

The map output device receives the link maps that result from the linking 
process. It is sometimes useful to list the link maps on the terminal or a 
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line printer, in which case. you should specify TT: or LP:, respectively, for 
the map output device. 

If you specify the name of a block-replaceable device, such as a disk, you 
can send the link maps as files to that device. Send the link maps to a disk 
(instead of a terminal or line printer) so that you will be sure they are 
saved. DIGITAL requires that you include a link map and answer file list- 
ing whenever you submit a Software Performance Report (SPR) for a moni- 
tor created by SYSGEN. 

You can suppress the link maps altogether by sending the output to the 
null device (answer NL: to the SYSGEN question "What is the name of the 
map output device?"). However, DIGITAL strongly recommends saving the 
link maps. 

Figure 1-3: All Files on One Disk for System Build 




SYSGEN PROGRAM 
EXECUTION COMPLETE 



SYSTEM DEVICE 
monitor 
SWAP. SYS 

system device handler 
MACRO 
LINK 
PIP 

SYSMAC.SML 
,SYSBLD.COM 
M0NBLD.COM 
DEVBLD.COM 

SRC: (source Input device) 
SYSGEN. CND 
SYSGEN.TBL 
appropriate system source files 

BIN: (binary output device) 

MAP: (map output device) 




SYSTEM BUILD 

(ASSEMBLY AND LINKING) 

COMPLETE 



SYSTEM DEVICE 
monitor 
SWAP.SYS 

system device handler 
MACRO 
LINK 
PIP 

SYSMAC.SML 
SYSBLD.COM 
M0NBLD.COM 
DEVBLD.COM 

SRC: (source input device) 
SYSGEN.CND 
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appropriate system source files 

BIN: (binary output device) 

receives built system Hies 

MAP: (map output device) 

receives iinl< maps in file 
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Figure 1-4: Source Files on Second Disk for System Build 
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Figure 1-5: Second Disk and Line Printer Receive System Biiild 
Output 
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1.2.5.2 Manual System Build — You may need to use a sequence of individ- 
ual commands to build the system or one or more components of the system. 
Use this manual method if you do not have enough mass storage space to 
execute the entire command file or if you need to rebuild a particular com- 
ponent because an error occurred when you built it. 

In this case, specify devices included in your configuration. (Refer to the 
questions asking for device names in the "Device Assignments and 
SYSGEN Cleanup" section of the SYSGEN dialog.) However, you need not 
plan the arrangement of files on SRC:, BIN:, and MAP:, since you will not 
be using the indirect command files SYSGEN.MON, SYSGEN.DEV, and 
SYSGEN.BLD to build the system automatically. You will need the indi- 
rect files for information, and you will need to arrange specific files on 
diskettes in order to perform the system build procedure. 

If you intend to perform the system generation process on an RXOl or RX02 
diskette system, or on a Professional 325, you will have to use the manual 
system build procedure, because you cannot fit all the required files on two 
diskettes. Consequently, you must arrange the files so that you can copy 
them to your system volume a few at a time and perform the component 
assemblies. Chapter 3 provides step-by-step procedures for generating spe- 
cial monitors and handlers on diskette systems. Those procedures require a 
special organization of files on diskettes for the assembly procedure. Study 
Chapter 3 if you need to use manual system build procedures. 

1.3 Studying the SYSGEN Dialog 

The SYSGEN dialog is reproduced here so that you can study it. When you 
run the program SYSGEN.COM, most of this dialog prints on your termi- 
nal. Some dialog questions appear only if you answered a previous question 
in a specific way. Therefore, SYSGEN may not ask you all the questions 
shown in this dialog. 

Default answers are shown in parentheses. If you respond to a question by 
pressing only @il), the default answer is used. 

The following dialog that prints on your terminal when you run SYSGEN 
appears below as actual computer output. Additional information follows 
the actual SYSGEN dialog. 

»»*»•»*##*•»**»*•»**■»#*«*«■•»*»»»**#*######■»**#***•»♦****♦*#»*»**»»#* 

RT-ll SYSTEM GENERATION PROGRAM MS 
#**#*#»*#**»■»■»*»♦*#»•»■)(•»**** ###**#»#-»*»***-»**-»#***#«#*»####***## 

Do y 1.1 w ant an introduction to system feneration ( N ) ? 

Type "Y" for a detailed explanation of the system feneration 
process. 
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Respond YES if you want to read an introduction to the system generation 
process. 

The S •/ s t e III Generation ( S Y S G E N ) program functions as an inter- 
actiue dialog in which the program asKs you a series of 
questions. Your answers establish the characteristics and 
features of the monitor(s) and deyice handlers that the program 
3enerates. SYSGEN prints each question and waits for your 
response. You can reply immediately with a valid response, or 
you can obtain a detailed explanation of the question by typins 
the ESCAPE Key followed by the RETURN Key. You can prevent 
SYSGEN from printing the entire explanation by t y p i n 3 < C T R L / > 
at any time d u r i n S the explanation. SYSGEN then stops p r i n t i n 3 
the explanation, prints the question, and waits for your 
response . 

SYSGEN can Generate one or more monitors from the output of one 
dialog session, depending on the responses you siue. However, 
your responses durins a session apply to all the monitors 
3enerated durin3 that session. 

The system 3eneration process produces two conditional files and 
three indirect command files as output. To produce these files, 
the SYSGEN dialoS asKs you questions about the tar3et system 
conf i 3u rat i on and about monitor and device support options you 
want. To be able to respond effectively, you should read the 
RT-11 SYSTEM GENERATION GUIDE before proceedin3. 

The dialo3 simply asks a question and waits for your response. 
Althou3h the dialo3 questions are sequentially numbered, certain 
responses cause SYSGEN to sKip some questions which do not apply 
for the system you are 3eneratin3. 

DialoS questions require one of several types of responses. 
Responses may be in the form of a character strin3» a number, or 
YES/NO (Y/N). SYSGEN expects a decimal number for all numeric 
answers except for CSRand vector addresses! in these cases it 
expects an octal number. A default response, in parentheses, 
follows each question. If you choose to use the default 
response, type only RETURN in response to the question. 

To terminate SYSGEN at any time, type <CTRL/C>. 

Do you want to use a previously created answer file (N)? 

SYSGEN can use commands and responses contained in an answer file 
to determine the characteristics of the monitors and device 
handlers for your tarset system. If you choose to use an answer 
file. SYSGEN uses the responses in the answer file instead of 
printin3 the interactive dialo3 to obtain your responses. 

Answer files that create the distributed monitors and handlers 
are included on the RT-11 distribution Kit. You can also use 
answer files that you have created durins earlier system 3ener- 
ation sessions. 

What answer file do you want to use ( SYSGEN . AN3 ) ? 

Type the device, filename and filet ype of the answer file you 
want to create. Use the followin3 format for your response: 

ddnsfilnam.typ 

The variable ddn is the device name and unit number where the 
answer file is to reside, and filnam.typ is the filename and 
filetype of the answer file you are creating. 



1-18 Preparing for System Generation 



If the specified answer file cannot be found, has an invalid file name, or 
cannot be accessed, SYSGEN issues an appropriate error message. 

Do you want to create an answer file (N)? 

Type Y to create an answer file that reflects the responses you 
make durinS this session. This answer file can he used during a 
later SYSGEN session. 

What answer file do you want to create ( SYSGEN . ANS ) ? 

Type the deuicet filename and filet ype of the answer file you 
want to create. Use the following format for your response: 

ddnsfilnam.typ 

The variable ddn is the device name and unit number where the 
answer file is to reside* and filnam.typ is the filename and 
filet ype of the answer file you are creatine. 

If the specified answer file already exists or is invalid, SYSGEN prints the 
following warning message and question: 

?SYSGEN-W-Fi le already exists d dn : f i 1 nam . t y p 

Do you want to create a new SYSGEN. ANS file (N)? 

A file already exists with the same name as the answer file you 
have chosen to create. If you still want to use this name for 
your output answer file* the data contained in the already 
existing file of the same name will be lost. 

SYSGEN now checks for protected output files and prints: 

...checking for protected output files. 

If any are protected, SYSGEN prints: 

?SYSGEN-F-Protected file already exists <filename> 

*»********»*»*»*#*»**»**#»•»■»*♦*■»•■)»■##»##*****#»*•»*■»•»#•»*»**#»***#** 
MONITOR TYPE 



You must respond YES to at least one of questions 1 through 3. Each 
SYSGEN run must build at least one monitor. You cannot build device 
support without building a monitor. 

1. Do you want the sinSle-Job (SJ) monitor (Y)? 

SINGLE-JOB MONITOR: 

The sin3le-Job (SJ) monitor provides an environment suitable for 
developing simple FORTRAN or BASIC applications. The SJ monitor 
includes many of the same features as the fore3round/back3round 
(FB) monitor — it supports all hardware devices (except the memory 
(nanasement unit)» all programmed requests (except .MRKT and 
.CMKT) t and all the utility programs. It offers the most features 
in the smallest size. You can add features during SYSGEN t but at 
the cost of increased monitor size. 
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Respond YES if you want to generate an SJ monitor. Review Section 1.1.2 
of the RT-11 Installation Guide to compare the advantages of the various 
monitors. In addition, Appendix A in this manual gives the SYSGEN an- 
swers that will duplicate the distributed monitors. 

2 . Do v u want the f o r e 3 r o u n d / b a c K 3 r o un d ( F B ) w o n i t o r ( Y ) ? 

FOREGROUND /BACK GROUND MONITOR: 

The f re Sround/bacK 3 round (FB) monitor offers an extended set of 
features that aid real-time or data acquisition applications. In 
addition to the foreground Job capability) this monitor supports 
serialized asynchronous I/O and additional proSrammed requests 
(inoludinS ,MRKT and .CMKT). 

Respond YES if you want to generate an FB monitor. Review Section 1.1.2 
of the RT-11 Installation Guide to compare the advantages of the various 
monitors. 

3 . Do you want the extended memory ( X M ) monitor ( N ) ? 

EXTENDED MEMORY MONITOR: 

The extended memory (XM) monitori which supports up to IZflK words 
of memory* is a version of the FB monitor. It requires KTll 
hardware (the memory manaSement unit) and the extended instruc- 
tion set (EIS). The XM monitor supports additional pro 3 rammed 
requests that allow you to extend a proSram's logical addressing 
space. Howevert the XM monitor is larSer than the FB monitor and 
requires that the user service routine (USR) be resident. 

Respond YES if you want to generate an XM monitor. Review Section 1.1.2 
of the RT-11 Installation Guide to compare the advantages of the various 
monitors. 

»»##***»#»*»****•»»»»*•»■»■»»■»»#■»»♦««■««•»***#»■»*«•»*■«•*»»**■»*•»****•***■* 

MONITOR OPTIONS 
******-)(-*#*»****#*****»*«*«*#»»****#«****»«*«****«************-** 

Note that when you select certain options, SYSGEN automatically enables 
other options, even if you respond NO to the questions. For example, if you 
respond NO to SJ timer support and device timeout support but YES to 
multiterminal support, SYSGEN enables SJ timer support and device 
timeout support anyway. 

a. Do you want timer support in the SJ monitor (N)? 

SJ TIMER SUPPORT OPTION: 

The SJ monitor normally does not include timer support. You can 
include this support* which enables you to use the .MRKT (marK 
time) and .CMKT (cancel marK time) proSrammed requests. 

Respond YES if you want to use the .MRKT and .CMKT programmed re- 
quests with the SJ monitor. The FB and XM monitors support these pro- 
grammed requests, which provide timer capability. However, you must spe- 
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cifically select this support for SJ, since it adds approximately 360 (deci- 
mal) words to the resident monitor. Timer support reduces response time 
slightly because of the additional interrupt-level overhead. If your applica- 
tion requires timer support, you must select it. Note also that the SJ moni- 
tor increments the date at midnight only if you select this support. RT-11 
does not require it. 

5 . Do '/ 1.1 want d e u i c e time-out support ( N ) ? 

DEUICE TIME-OUT SUPPORT OPTION: 

The deMice time-out option permits d e m i c e handlers to issue .MRKT 

( m a r K time) programmed requests. D E C n e t support requires this 

option. 

Respond YES if you are a DECnet user or if your application uses device 
timeout support. RT-11 does not use this support. This support adds ap- 
proximately 40 (decimal) words to the resident FB and XM monitors; it 
adds approximately 360 (decimal) words to the resident SJ monitor, since 
enabling this support automatically enables SJ timer support. 

B . Do v u want an error m e s s a 3 e on system I/O errors ( Y ) ? 

ERROR MESSAGE ON SYSTEM I/O ERRORS OPTION: 

The SJ monitor normally halts if a fatal system I/O error occurs. 
You can replace, this halt with a system error message. DIGITAL 
highly recommends this option if the system will be used by 
anyone but the most experienced individuals. 

Respond YES if you want an error message instead of a system halt when 
the SJ monitor detects a fatal I/O error. Although this option adds approxi- 
mately 30 (decimal) words to the resident monitor, DIGITAL strongly 
recommends this option for all but the most space-conscious applications. 
The confusion this option saves is well worth the small amount of addi- 
tional memory it requires. The FB and XM monitors include this support. 

7 . Do you want system job support ( N ) ? 

SYSTEM JOB OPTION: 

The system Job option allows you to run up to e i S h t simultane- 
ously active Jobs. The error loader* the SPOOL proSranw UTCOM i 
and the QUEUE proSraw can be either foresround Jobs or system 
Jobs. If you want to r u n more t h a n one si m u 1 1 a n e o u s 1 y t or if 
y u w ant to r u n any one a 1 o n S with a f o r e S r o u n d Job* y o u need 
system Job support. 

Respond YES if you want system job support. You need this support if you 
use the error logger, SPOOL, VTCOM, or the device queue program 
(QUEUE) as well as a foreground job, or if you use the error logger, 
SPOOL, VTCOM, or QUEUE together. (Note that you need not select sys- 
tem job support if you intend to run the error logger only under the SJ 
monitor.) You can also use system job support to create application-spe- 
cific system jobs. This support adds approximately 300 (decimal) words to 
the resident monitor. 
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B, Do you want to use the .SPCPS request (N)? 

SAME/SET MAIN-LINE PC AND PS OPTION: 

The s a y e / s e t m a i n - 1 i n e PC and PS option is a conditionally 
assembled programmed r e =i u e s t for the F 5 and KM monitors. The 
.SPCPS request changes the flow of control of m a i n - 1 i n e code by 
s a M i n S the m a i n - 1 i n e code PC and PS and o h a n S i n S the m a i n - 1 i n e PC 
to a new y a 1 u e . This request ma y be u s e f u 1 in m u 1 1 i - u s e r 
applications to control s w i t c h. i n 3 a m o n S users. 

Respond YES if you want to use the .SPCPS request. Refer to the RT-11 
Programmer's Reference Manual for more information about this pro- 
grammed request. 

9. Do you want Global SCCA support (N)? 

GLOBAL SCCA SUPPORT OPTION: 

The SCCA programmed request inhibits c o n t r o 1 / c ' s until the 

currently running program exits. Global SCCA support allows you 

to issue a p r o 3 r a m m e d request that will inhibit c o n t r o 1 / c ' s e u e n 

after a p r o 3 r a m exits. C o n t r o 1 / c ' s will remain inhibited until 

a 3lobal SCCA programmed request is issued to explicitly turn it 

off. 

10. Do y u want m u 1 1 i t e r m i n a 1 support ( N ) ? 

MULTITERMINAL SUPPORT OPTION: 

The m u 1 t i t e r m i n a 1 option lets you use special programmed 
requests to do I/O to more than one terminal. RT-11 normally 
supports only one terminal interfaced through the console ( D L 1 1 ) 
which is shared by both b a c K 3 r o u n d and f o r e 3 r o u n d Jobs. You c a n 
select multiterminal support for up to IB terminals interfaced 
throu3h a choice of DLll and DZll interfaces. Subsequent 
questions will establish the number and type of interfaces. Note 
that "if you choose multiterminal support your system cannot 
support UTll or VSBO 3raphics. 

Respond YES if you want multiterminal support and are generating an SJ, 
FB, or XM monitor. This option selects monitor support for up to 16 termi- 
nals. However, if the application itself provides support for additional ter- 
minals and if you require only console support in the monitor, you should 
not select this support. MU BASIC-11 requires that you respond YES to 
this question. 

You need not select multiterminal support to use a hard copy terminal as a 
line printer. You need only the serial line printer handler, LS.SYS, which 
is included in the software kit. 

Multiterminal support adds considerably to the space requirements of the 
resident monitor. It adds a minimum of 750 (decimal) words for the first 
additional terminal and approximately 100 (decimal) words for each addi- 
tional terminal. However, the exact number of words added depends on the 
interfaces, the configuration, and the other options you select. 

11. D y u w ant as y n c h r o n o u s terminal status ( Y ) ? 

ASYNCHRONOUS TERMINAL STATUS OPTION: 

The asynchronous terminal status option provides a program with 

the updated status of a terminal and modem. When a program 
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attaches a terminal » the program can supply a status word that 
the monitor updates as changes occur in the terminal status 
(double CTRL/C » input au a i 1 afa 1 e » output buffer empty » carrier 
present). This support is required for MU BASIC applications. 

Respond YES if you are an MU BASIC user or if your application uses 
asynchronous terminal status information. If you are in doubt about this 
option, respond YES. This support applies only to multiterminal applica- 
tions, so SYSGEN asks you this question only if you respond YES to ques- 
tion 10. 

12. Do y u w a n t multiterminal time-out support ( Y ) ? 

MULTITERMINAL TIME-OUT OPTION: 

Multiterminal time-out support causes the monitor to reset (at 
regular intervals) any terminal that may h a y e 3 o n e off-line. 
This action helps to minimize the impact of static and similar 
problems. DIGITAL recommends selecting this option if your 
application requires maximum terminal availability. 

Respond YES for maximum terminal availability. If you are an MU 
BASIC-11 user, be sure to select this support. 

This support applies only to multiterminal applications, so SYSGEN asks 
you this question only if you respond YES to question 10. DIGITAL recom- 
mends that you select this option unless you have space problems. 

13. Enter the size of the output buffers (40): 

OUTPUT RING BUFFER SIZE OPTION; 

The RT-11 terminal service requires a set of output rins buffers 
•for each supported terminal. The output rins is a buffer in the 
monitor that holds characters until the terminal can print them. 
(A program can send characters faster than a terminal can print 
them.) 

Respond with the number (decimal) of characters that you want the moni- 
tor to hold in the output ring buffers. Each character adds n bytes to the 
resident monitor size, where n is the total number of terminal lines. Note 
that you must count the carriage return and line feed combination as two 
characters. The range for valid responses is from 10 to 134. 

la. Enter the size of the input buffers (134): 

INPUT RING BUFFER SIZE OPTION: 

The RT-11 terminal service requires a set of input rins buffers 
for each terminal supported. The input rinS is a buffer in the 
monitor that holds the characters that you type at a terminal 
until a program requests them. You may want to chanSe the input 
rind size* in particular* since the size you need depends on the 
terminal's width and the amount of t y p e - a h e a d y o u expect. 

Respond with the number (decimal) of characters that you want the moni- 
tor to hold in the input ring buffers. If you specify an odd number of charac- 
ters, SYSGEN rounds the number down. Each character adds n bytes to the 
resident monitor size, where n is the total number of terminal lines. 
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You should make the input ring buffers large enough to hold at least one 
line of input. If the largest line accepted by an application is greater than 
134 characters, you can adjust the size of the input buffers. 

The minimum acceptable input buffer size is 74 characters. If you specify 
less than 74, an error occurs at monitor assembly time. The monitors re- 
quire 82-character buffers for efficient command operation. Buffers larger 
than 82 characters are useful if you anticipate using the type-ahead fea- 
ture. 

The RT-11 keyboard monitor and the .GTLIN programmed request accept 
up to 80 characters. However, if your program uses the VTIOO 132-charac- 
ter mode, you should select support for an input ring buffer of 134 charac- 
ters. 

The range for valid responses is from 74 to 254. 

15. Do you want to use the .FETCH request under X M ( Y ) ? 

If you choose .FETCH support under KM. then d e y i o e handlers can 
be fetched by user b a c K S r o u n d p r o S r a m s . A 1 s o t p r e - M e r s i o n 5 
proSraws which do not use the form of the .PROTECT directiue 
which includes automatic m e c t o r setup must be modified to do so. 
If you do not select this option* all in-line s e r y i o e routines 
iai u 1 d » as in Version 4 » h a i.i e to remain clear of the memory mapped 
by Kernel APR 1 and handlers must be loaded before use. 

.FETCH adds a p p r o x . 400. words to the resident monitor. 

IB. Do you w ant end of month and year date rollover ( N ) ? 

MONTH ROLLOUER OPTION: 

When y o u r u n a system continuously) oyer a Ions period of t i m e t 
you normally have to reset the date and time at the b e S i n n i n S of 
each month. You can select a feature that automatically sets the 
correct date and time. Howeyert this option Greatly increases the 
size of the monitor. 

■Respond YES if you want the date automatically reset at the beginning of a 
month or year and if space is not a serious concern. This option adds ap- 
proximately 50 (decimal) words to the resident monitor. 

20. D y u want the user c o m m and 1 i n K a S e ( Y ) ? 

USER COMMAND LINKAGE 

The user command 1 i n K a 3 e allows you to define y our o w n c o m w a n d s 
which can be issued in a format similar to the standard D C L 
c m m a n d s . 

21. Do you want h i 3 h speed r i n S buffer support ( N ) ? 

HIGH SPEED RING BUFFER 

When the hish speed rinS buffer is present* all character 
processing and interpretation is performed at forK level. The 
advantage of hauind the hish speed rinS buffer is that it allows 
short bursts of characters oomins in at a very hish rate. This is 
useful for systems with ',' T 1 or other terminals that report 
their status by sending a burst of i n f o r m a t i o n . t o the host 
computer. Use of the hish speed rinS buffer is especially 
recommended with a P D T . 
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22. Da you want all the Keyboard wonitor coiiHuands (Y)? 

KEYBOARD MONITOR COMMANDS OPTION! 

The Keyboard monitor commands option lets you choose the Keyboard 
monitor commands your Generated monitor will support. You will 
probably find all of the commands useful. H o w e y e r » you o a n 
reduce KMON size and assembly time if you select support for a 
subset of the available commands. You have a choice of three 
subsets (or any combination of subsets). The three command 
subsets you can choose are: the UTILITY PROGRAM COMMANDS* the 
LANGUAGE COMMANDS* and the MINIMAL COMMANDS. If you do not 
choose the complete set of commands or any of the subsets* you 
will be able to use only the RUN command. 



Respond YES if you want support for all the keyboard monitor commands. 
All the commands available with RT-11 are in the following list. If you 
choose the complete set of keyboard commands, the disk (or other device) 
file image of the SJ monitor is increased by 14 blocks and the image of the 
FB or XM monitor by 18 blocks. If you choose one of the subsets, the moni- 
tor disk file images will be smaller. 

NOTE 

If you want just one or several commands, select the appro- 
priate conditionals in Appendix C. 



ABORT 


ASSIGN 


B 


BACKUP 


BOOT 


CLOSE 


COMPILE 


COPY 


CREATE 


D 


DATE 


DEASSIGN 


DELETE 


DIBOL 


DIFFERENCES 


DIRECTORY 


DISMOUNT 


DUMP 


E 


EDIT 


EXECUTE 


FORMAT 


FORTRAN 


FRUN 


GET 


GT 


HELP 


INITIALIZE 


INSTALL 


LIBRARY 


LINK 


LOAD 


MACRO 


MOUNT 


PRINT 


PROTECT 


R 


REENTER 


REMOVE 


RENAME 


RESET 


RESUME 


RUN 


SAVE 


SET 


SHOW 


SQUEEZE 


SRUN 


START 


SUSPEND 


TIME 


TYPE 


UNLOAD 


UNPROTECT 







13* Do you want the UTILITY subset (Y)? 

The following commands are included when the UTILITY commands 
are chosen: 



BACKUP 


BOOT 


COPY 


CREATE 


DELETE 


DIFFERENCES 


DIRECTORY 


DUMP 


EDIT 


FORMAT 


INITIALIZE 


PRINT 


PROTECT 


RENAME 


SHOW 


SQUEEZE 


TYPE 


UNPROTECT 







Type Y if you want support fo-r the UTILITY subset of the 
Keyboard monitor commands. Type N if you do not want the subset 
or if you wish to specify individual commands by setting system 
conditionals. 



Preparing for System Generation 1-25 



Choosing this subset increases the size of the disk (or other device) image of 
the monitor file by only six blocks (rather than the 14 to 18 blocks for all 
the commands). Note that you can select more than one subset; SYSGEN 
asks you about the other subsets. However, SYSGEN does not ask this 
question if you respond YES to question 22. Note also that the R and RUN 
commands cannot be removed; they are included in all the sets of com- 
mands. 

Za, Do you want the LANGUAGE subset (Y)? 

The following ooiiunands are included when the LANGUAGE conunands 
are chosen: 

COMPILE DIBOL EXECUTE FORTRAN 

LIBRARY LINK MACRO 

Type Y if you want support for the LANGUAGE subset of the 
Keyboard monitor c o w m a n d s . Type N if y o u d o not want the s u b s e t 
or if you wish to specify individual c o w w a n d s b y d e f i n i n 3 
system conditionals later during this SYSGEN session. 

Choosing this subset increases the size of the disk (or other device) image of 
the monitor file by only four blocks (rather than the 14 to 18 blocks for all 
the commands). Note that you can select more than one subset. SYSGEN 
does not ask this question if you respond YES to question 22. The default 
response to this question is YES. 

25. Do you want the MINIMAL subset (Y)? 

The following commands are included when the MINIMAL commands 
are chosen: 



ABORT 


ASSIGN 


B 


CLOSE 


D 


DATE 


DEASSIGN 


DISMOUNT 


E 


FRUN 


GET 


GT 


HELP 


INSTALL 


LOAD 


MOUNT 


R 


REENTER 


REMOME 


RESET 


RESUME 


RUN 


SAVE 


SET 


SRUN 


START 


SUSPEND 


TIME 


UNLOAD 









Type Y if you want support for the MINIMAL subset of the 
K e y b a r d monitor c o m m a n d s . Type N if y o u d o not want the s u b s e t 
or if you wish to specify i n d i u i d u a 1 com m a n d s b y d e f i n i n 3 
system conditionals later d u r i n 3 this SYSGEN session. 

The execution code for all the commands in the MINIMAL subset is resi- 
dent in KMON. If you select this option but do not select FB or XM monitor 
support, SYSGEN does not include the commands FRUN, RESUME, and 
SUSPEND. If you select this subset but do not select support for VT-11 
graphics display, SYSGEN does not include the GT command. If you do not 
select system job support, SYSGEN does not include the SRUN command. 
Note, however, that you can select more than one subset. Choosing this 
subset increases the size of the disk (or other device) image of the SJ moni- 
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tor file by only six blocks and the FB or XM monitor file by only 10 blocks 
(rather than the 14 to 18 blocks for all the commands). SYSGEN does not 
ask this question if you respond YES to question 22. 

ZB, Do '/OI.I want the optional 50 Hz clock support (N>? 

50 HZ CLOCK OPTION: 

A line clooK Generates periodic interrupts to allow the system to 
Keep track of the t i w e . The number of ticks per second depends on 
the power line frequency) BO Hz or 50 Hz. R T - 1 1 assumes a BO Hz 
line frequency* but you can select support for a 50 Hz clock. The 
50 Hz frequency has specialized uses and is the common frequency 
in Europe. 

Respond YES if your computer's line frequency is 50 Hz. 

27. Do you want to use the KWll-P clock as the system clock (N)? 

PROGRAMMABLE CLOCK AS SYSTEM CLOCK OPTION: 

R T - 1 1 normally uses a line clock for the system clock. You can 
substitute the K W 1 1 - P p r o S r a in m a b 1 e clock as the system clock* but 
the KWll-P will not then be available for program use. The 
p r 3 r a m M a b 1 e clock normally allows you to program interrupts at 
preset intervals. 

Respond YES if your configuration includes the KWll-P clock and you 
want to use it as the system clock. The monitor uses the system clock for 
certain functions (time-of-day calculations, timer requests, and FB and XM 
scheduling). If the system clock is the programmable clock, your applica- 
tion cannot access the programmable clock or change its rate without af- 
fecting monitor function. Therefore, DIGITAL recommends that you use a 
line clock, if available, for the system clock. 

30. Do you want the s t a r t - u p indirect file ( Y ) ? 

STARTUP INDIRECT COMMAND FILE OPTION: 

This option causes the bootstrap to execute an indirect command 
file (with the name STARTx.COM » where x identifies the monitor) 
when starting the system. An indirect command file contains 
monitor commands that the monitor processes (in the order in 
which they appear) when the file is executed. A startup indirect 
command file is particularly useful for setting up initial 
conditions (for example* assisnins the default device to the data 
device* installing a device into the system tables when the 
device was not originally built into the system* or r u n n i n S a 
specific program). 

XVCOJ-ZWIXXJ. X JLlJk-/ XX J'V^'-*- VVa-XXf UXXC XXXV/XXXIjWX UUObOLiX CLp UU CA-CV^U-LC a Dtdl t"U.U iixu.i~ 

rect file every time you boot the system. If you select this support, the 
bootstrap looks for a file STARTx.COM to execute (where x is S, F, or X for 
single-job, foreground/background, or extended memory monitor). You cre- 
ate this file, with commands to perform whatever operations you choose. If 
no STARTx.COM file resides on a volume, the monitor prints an error 
message when you boot that volume. This option requires no additional 
resident monitor space. 
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31. Do '/ u want f 1 o a t i n 3 point support ( N ) ? 

FLOATING POINT OPTION: 

If v u r c n f i 3 LI r a t i n includes f 1 o a t i n 3 point hardware and y o u r 
application requires this feature) you should enable this option. 
Floating point hardware is available for many PDP-11 and 
Professional 300 series processors. This is especially useful 
for FORTRAN IM and BASIC-11 users whose applications perform 
data manipulations. 

Respond YES if your configuration includes the appropriate hardware and 
your application uses floating point manipulations. If you try to perform 
floating point manipulations but have not selected this support, system 
failure results. 

If you select this support, the monitor intercepts all floating point traps. If 
your program has not set up an exception handler, the monitor prints an 
informative message and aborts the program. If your program has set up an 
exception handler, that routine is entered with the FPU status (if appropri- 
ate) on the stack. The monitor makes sure that the correct job's context is 
set up. 

In addition, if you select floating point support, the .SFPA programmed 
request (refer to the RT-11 Programmer's Reference Manual) is enabled. If 
you do not choose floating point support, none of the functions of .SFPA is 
performed; for example, the floating point registers are never context 
switched. 

If you do not include floating point support, all programs that use the 
floating point instructions must set up and .PROTECT or .CNTXSW the 
vector. FORTRAN IV requires monitor floating point support if you use one 
of the floating point libraries. 

Floating point support adds approximately 200 (decimal) words to the resi- 
dent SJ and FB monitors and approximately 300 (decimal) words to the 
resident XM monitor. 

3 2 1 Do you want memory parity support ( N ) ? 

MEMORY PARITY SUPPORT OPTION: 

If your configuration includes memory parity hardwares you should 
select this option. Memory parity hardware oheoKs for memory 
errors and this option enables RT-11 support for the hardware. 
RT-11 issues an error message and supplies the location of access 
when a memory error occurs. If you h a y e this hardware but do not 
enable this supports the system halts when memory errors occur. 
If you select error lo33ins as well as memory parity support* the 
error lo33er lo3s parity errors as well as device errors. 

Respond YES if your configuration includes memory parity hardware. 
Memory parity support adds approximately 8 (decimal) words to the resi- 
dent SJ monitor and approximately 25 (decimal) words to the resident FB 
and XM monitors. If you have this hardware, you need RT-11 memory 
parity support both to make use of the hardware's capabilities and to avoid 
unwanted system halts. 
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33. Do v 1.1 want power failure messages ( N ) ? 

POWER FAILURE MESSAGE OPTION: 

The monitor normally halts on power r e o o i.i e r '/ startup after a 
power failure. You can elect to h a y e the Monitor print a m e s s a 3 e 
■ e X p 1 a i n i n 3 that power failure caused the halt. H o w e v e r t you must 
not select this option if you have semiconductor memory* which is 
volatile. 

Respond YES if you want an error message on start-up after system halt to 
report the cause of the halt. Select this option only if your hardware config- 
uration includes core memory or battery backup, not semiconductor mem- 
ory (which is volatile). This option adds approximately 90 (decimal) words 
to the resident monitor. However, DIGITAL strongly recommends this op- 
tion, since it quickly identifies the cause of failure. Frequently, system 
halts are caused by power failures too brief to detect visually. 

3a. Do you want BATCH support (N)? 

BATCH SUPPORT OPTION: 

You can select support for the BATCH Job control lanSuaSet which 
allows RT-11 to operate unattended. Once you prepare a BATCH 
stream* you can 1 e a u e it for an operator to start and run* and 
the BATCH stream will execute programs or monitor commands 
without your intervention. Indirect command file support* which 
offers similar capabilities* is separately available in all 
monitors. You need not select BATCH support to obtain indirect 
command file support. 

Respond YES if you want BATCH support. RT-11 BATCH support is simi- 
lar to indirect command file support, but it offers certain advantages. 
BATCH produces a log file, allows job-stream programmability, and per- 
mits the operator to interact with the job during execution. Unless you need 
the features not provided by indirect command file support, you need not 
select this support. 

35. Do you want error lossina (N)? 

ERROR LOGGING OPTION: 

The error loSSinS option creates the error loSSinS (EL) system 
Job* and incorporates error lo33in3 support in the device 
handlers. Error loSSinS reports device* memory parity (if 
selected)* and memory cache errors. When error lo33in3 is 
enabled* most device handlers call EL on each successful transfer 
and on each error. The EL Job retrieves information from the 
handlers that is later available to you in summary report format. 

Rpsnnnrl VTT.S if vnn wmnt tn nsp t^e e^for Incrcrincr svatpm inh TTiis nntinn 

adds approximately 2000 (decimal) words to the resident monitor and 50 
(decimal) words to each device handler you generate. However, error log- 
ging is useful in monitoring system reliability. 

3 B . How many device units does error 1 o 3 Job support (10)? 

NUMBER OF UNITS SUPPORTED BY ERROR LOGGING OPTION: 

The error 1 o 3 3 e r can handle up to 34 individual device units. 

You can conserve space by r e d u c i n 3 the number of units the 1 o 3 3 e r 
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can handle to the specific n u m b e r of supported units in the 
target configuration. 

Respond with the number (decimal) of supported device units in the system 
you are generating. For example, if the target system has three RK05 
drives and a dual diskette drive, the response is 5. Each unit adds seven 
words to the error logger. The range for valid responses is from 1 to 34. 
SYSGEN asks this question only if you respond YES to question 35. 

BB. Do you want to define an-/ o t h e r. s >- s t em conditionals (N)? 

Some of the conditionals which the monitors and d e m i c e handlers 
use are not set as a result of the SYSGEN questions. An example 
is PDT$DP. which causes the system to be built with code which is 
optimal for a, PDT. Respond with Y if you want any system 
conditionals to be included in your system conditional file which 
are not normally defined through SYSGEN. 

Enter system conditional definition in the form 

s y m b 1 = v a 1 u e 

Type <ESCAPE> <RETURN> for help, 

Type ?<RETURN> to list user system conditional definitions. 

Type .<RETURN> when all user system conditionals have been defined. 

B 9 . Enter the system conditional and value: 

Enter the system conditional definition as you want it to appear 
in the system conditional (.CND) file. For example: 

PDT$OP = 1 ; Generate PDT optimal code 

DEVICE OPTIONS 

Type <ESCAPE> <RETURN> for help. 

Type ?< RETURN :> to list all devices. 

Type . < R E T U R N > when device selection is complete. 

Enter the device name you want support for Cddl: 

The device options let you select the peripheral devices that the 
Generated system will support. By selecting support for a 
specific device* you make the device Known to the monitor's 
device tables, and SYSGEN Generates a device handler named 
KX.SYGf (where xx is the physical device name) for the device. 
If you do not select a specific device at this timet you will 
have to create the device handler separately and use the monitor 
INSTALL command before you can access the device. 

The followins is a list of the valid RT-11 devices and their 
associated device names. SYSGEN will display the device name 
list e a c h t i m e you type a -question mark (?) followed by a 
carriage return in response to the device name question. An 
asterisk (*) will precede the device name if selected. Type a dot 
when you have entered all the device names you want support for. 

Do you want a list of available devices (Y)? 
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A YES response causes SYSGEN to list all valid RT-11 devices and their 
associated device names. An asterisk (*) precedes those devices for which 
support has already been selected. Valid RT-11 devices are: 

DX RXOl Single-Density Diskette DY RX02 Double-Density Diskette 

DD TU58 DECtape II RK RK05 Cartridge Disk 

DL RL01/RL02 Cartridge Disk DM RK06/RK07 Cartridge Disk 

MT TMll (UNIBUS) Magtape MM TJU16 (MASSBUS) Magtape 

MS TS11,TU80/TSV05 (UNIBUS/Q-BUS) Magtape NL Null Handler 

LP Line Printer DU MSCP Disk Class Handler 

LD Logical Disk Handler VM Virtual Memory Handler 

DZ RX50 PRO300 Series DW RD50/RD51 PRO300 Series 

SP Transparent Spooling Handler XL VTCOM Communication Handler 

XC VTCOM Handler for PC325/350 LS Serial Line Printer 



100. Do you want support for a s e c o n d < d e i.) i c e > controller ( N ) ? 

SYSGEN asks this question only if you request RXOl (DX), RX02 (DY), or 
DECtape II (DD) support. 

The < R X 1 / 2 d i s K e 1 1 e or T U 5 8 o a r t r i d S e > subsystem supports only 
two d r i M e s for each controller. If your system o o n t a i n s f o u r 
d r i M e s f a second controller 3 o m e r n s the third and fourth 
u n i t s t and you must select RT-11 support for it. 

Respond YES if your target configuration includes four <device> drives. 
Note that you can boot RT-11 only from Unit or Unit 1. 

101. Do y u w ant R K 2 double density only support ( N ) ? 

The R K 2 diskette supports both single and double densities by 
default. If you select d o u b 1 e - d e n s i t y only support* you c a n 
slightly i m p r y e the performance and reduce the size of the 
device handler. 

Respond YES if you plan to use only double-density diskettes. SYSGEN 
asks this question only if you request RX02 (DY) support. 

102. What is the CSR address for the <nth> < d e m i c e > (nnnnnn)? 
The yalid ranSe for the CSR address is from IBOOOO to 177570. 

SYSGEN asks this question only if you request RXOl (DX), RX02 (DY), or 
DECtape II (DD) support. Respond with the appropriate CSR address(es) 
for the device controller(s). The field service representative who installs 
your hardware system is responsible for supplying you with a written rec- 
ord of addresses at which he or she installs each device. The default (octal) 
addresses appear in parentheses. 

103. What is the m e c t o r address for the < n t h > < d e i.i i c e > ( n n n ) ? 

For the first and second RXOl, RX02, and DECtape II controllers: 

The valid r a n S e for the i.i e c t o r address is from 100 to 474. 
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SYSGEN asks this question only if you request RXOl (DX), RX02 (DY), or 
DECtape II (DD) support. Respond with the appropriate vector address(es) 
for the device controller(s). The field service representative who installs 
your hardware system is responsible for supplying you with a written rec- 
ord of addresses at which he or she installs each device. The default (octal) 
addresses appear in parentheses. 

104. How (iianv disk platters are installed on the RFll (1)? 

Respond with the number (deoiwal) of RFll platters included in 
your RFll subsystem. The ranSe of ualid responses is from 1 to 8. 

SYSGEN asks this question only if you request RFll support. 

105. Do you want RJS03 rather than RJS04 support (Y)? 

Type Y if your target system includes an RJS03 disK subsystem 
rathe r than an RJSOfl. 

If your response is NO, SYSGEN prints the following message: 

RJS04 support assumed. 

SYSGEN asks this question only if you request RJS03/04 MASSBUS fixed- 
head disk support. 

lOB. How many RL01/RL02 units are to be supported (2)? 

Enter the number (decimal) of RL01/RL02 units included in your 
RL01/RL02 subsystem. The ran3e of ualid responses is from 1 to H > 

SYSGEN asks this question only if you request RL01/RL02 cartridge disk 
support. 

107; Do you want RPR02 rather than RPR02/RP03 support (N)? 

Type Y if your target system includes an RPR02 disK subsystem 
rather than RPR02/RP03. 

If your response is N, SYSGEN prints the following message: 

RPR02 and RP03 support are assumed 

SYSGEN asks this question only if you request RPll support. 

108. How many ports are to bei supported (1)? 

Enter the number of ports you want the MSCP disK class handler 
to support. 

110. Do you want support for banner p a 3 e s ( Y ) ? 

Type Y if you want banner p a S e support to be included in the SPOOL 
hand 1 e r . 



1-32 Preparing for System Generation 



120. Do ■/ u want the f i 1 e - s t r u c t u r e d m a S t a p e handler ( Y ) ? 

FILE-STRUCTURED MAGTAPE OPTION: 

R T - 1 1 (ii a 3 1 a p e support is available in two f o r w s . The standard 
form is f i 1 e - s t r u o t u r e d m a 3 1 a p e s u p p o r t t which uses a subset of 
ANSI file format. The file-structured handler stores and 
retrieves data in a file format usable with most R T - 1 1 system 
programs. The second form of mastape support, ha-rdware handler 
support, omits file s t r u o t u r i n S and reads and writes data 
directly in variable length records. While this handler is sig- 
nificantly smaller than the f i 1 e - s t r u o t u r e d handler, y o .u cannot 
use it with any system programs. The f i 1 e - s t r u c t u r e d handler can 
also perform direct hardware functions. 

Select this option only if you intend to use any of the system programs, 
RT-11 commands, FORTRAN IV programs, or BASIC-11 programs with 
the magtape. 

121. How many m a 3 1 a p e units are to be supported ( 2 ) ? 

NUMBER OF MAGTAPE UNITS OPTION: 

The maStape handler requires table space for each mastape unit. 
You can minimize the size of the m a 3 1 a p e handler by limiting the 
n umber of units it o a n simultaneously handle to the n u m b e r 
actually present on the target machine. 

Respond with the number (decimal) of magtape drives included in your 
magtape subsystem. SYSGEN asks this question only if you responded 
YES to question 120. The range for valid responses is from 1 to 8, and the 
default response is 2. 

122. What is the address of the < n t h > unit ( n n n n n n ) ? 

Each TSll unit requires two contiguous UNIBUS addresses for 
status registers. Enter the address (octal) of the < n t h > unit. 
The r a n 3 e of valid responses is from 1 B to 177570. 

If you request TSll support, SYSGEN asks questions 122 and 123 once for 
each TSll tape unit you wish to support. SYSGEN asks you for the ad- 
dresses of as many units as you specified. Respond with the address (octal) 
of each TSll unit. The field service representative who installs your hard- 
ware system is responsible for supplying you with a written record of ad- 
dresses at which he or she installs each device. 

Up to eight TSll controllers can be supported. Default status register ad- 
dresses and vector addresses are as follows: 

XV^UK VCijki'<0 W XM.JLV Jl.*i\^ ^JLi^ V\^ X A. S.VB.'UIX ^^OiS T V^i^ %i\JI X. 4. A.V4LV4.JL 't^OO 

1 172522 224 

2 172526 300 

3 172532 304 

4 172536 310 

5 172542 314 

6 172546 320 

7 172552 324 

8 172556 330 
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123. What is the u e o t o r address of the < n t h > unit ( nn n ) ? 

Enter the yector address (octal) of the first unit. The ranse for 
valid responses is from 100 to m ii , 

130. Does your printer h a u e a nonstandard u e c t o r or C S R ( N ) ? 

The standard line printer m e o t o r address is 200 and the standard 
CSR address is 17751^^. If your printer is installed at another 
vector or CSR address, specify the correct values. 

Respond YES if the line printer control register address is not 177514 or 
the vector address is not 200. These addresses usually are nonstandard only 
if the printer is an LA180S. 

SYSGEN asks this question only if you request parallel line printer (LP) 
support, and asks questions 131 and 132 only if the response is YES. 

131. What is the CSR address for the printer (177514)? 

Respond with the address of the control register for the line 
printer. The r a n 3 e for valid responses is from 1 B to 177570. 



The field service representative who installs your hardware system is re- 
sponsible for supplying you with a written record of addresses at which he 
or she installs each device. 

SYSGEN asks this question only if the answer to question 130 is YES. 

132. What is the vector address for the printer (200)? 

Respond with the vector address for the line printer. The ranSe 
for valid responses is from 100 to lili\ , 

SYSGEN asks this question only if the answer to question 130 is YES. 

133. Do you want support for the PC300 printer port (N)? 

Type Y if you will be using the L S handler with the P C 3 series 
of personal computers. 

134. What is the CSR for the serial line printer ( n n n n n n ) ? 

Respond with the address of the control register for the serial 
line printer. The r a n S e for valid responses is from 1 B to 
177570. 

NOTE 

If you answered YES to question 133 » the default CSR 
is 173ia00. If you answered no» the default CSR is 
17B500. 



SYSGEN asks this question only if you request serial line printer (LS) 
support. The field service representative who installs your hardware sys- 
tem is responsible for supplying you with a written record of addresses at 
which he or she installs each device. 
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135. What is the vector for the serial line printer (nnn)? 

Respond with the Meotor address for the serial line printer. The 
r a n S e for valid responses is from 100 to 4 7 ii . 

NOTE 

If you answered YES to question 133* the default 
vector is 220. If you answered no» the default vector 
is 30 . 

151. What is the CSR address for XL (17G500)? 
Enter the CSR ad d re s s ( a c t a 1 ) o f XL . 

152. What is the vector address for XL (300)? 
Enter the vector address (octal) of XL. 

SYSGEN asks this question only if you request serial line printer (LS) 
support. 

Do you want to add support for a n y of y o u r own devices ( N ) ? 

SYSGEN will senerate cawiiiands to assemble and link any user 
supplied device handlers. SYSGEN also adds the device names to 
the system device tab.les in DEUTBL.MAC. 

Type <E.SCAPE> <RETURN> for help, 

Type ?<RETLIRN> to list all devices. 

Type . < R E T U R N > when device specification is complete. 

Enter the device name you want support for [ d d ] : 

Enter the 2 character device name for the device for which you 
are supplying a device handler. 

ISO. How many extra device slots do y o u w ant ( ) ? 

EXTRA DEVICE SLOT OPTION; 

SYSGEN allocates space in the monitor for only the devices 
specified. You can allocate additional space by requesting 
empty device slots. Allocate one empty slot for each device you 
intend to add to the system after it is built. Also keep in mind 
that the 'number of logical device assignments you will be able 
to make in the running system is equal to the number of devices 
plus empty device slots in the system you have Generated. Y o u 
may need to allocate extra device slots for logical device 
assignment purposes. 

Respond with the number (decimal) of extra device slots you need. If a 
device will be supported only by an in-line service routine in a particular 
application and not by a system handler, you need not set aside a device 
slot for it. Remember also to consider the number of logical device assign- 

GRAPHICS OPTIONS 

170. Do you want VTll or VSGO graphics support (N)? 

Type Y if your target configuration includes a U T 1 1 or S B 
graphics subsystem. R T - 1 1 support for ',' S B is minimal. The 
display h a n d 1 e r t U T H D L R t supports U T 1 1 but does not support any 
special features of MSBO. 
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171. Do you want MSGO support (N)? 

Type y if the graphics subsystem is U S G . 

If your response is NO, SYSGEN prints the following message: 

y T 1 1 hardware assumed. 

172. Nhat is the CSR address for the MTll/ySBO (172000)? 

The CSR addresses can be floating. The' presence or. absence of 
such floating address deyices affects the addresses at which the 
other floating address devices in the system are installed. 
Floating address devices must be installed in a standard 
sequence. 

The standard VTll/USBO CSR address is 172000. Howeyert UTU/VSBOs 
can use floating addresses. If your UTll/MSBO is installed at 
nonstandard CSR addresses, supply the correct value. The valid 
r a n 3 e for responses is from 1 B to 177570. 

Respond with the address (octal) of the control register for the VTll or 
VS60. The range for valid responses is from 160000 to 177570. The field 
service representative who installs your hardware system is responsible for 
supplying you with a written record of addresses at which he or she installs 
each device. 

173. What is the vector address for the UTll/VSBO (320)? 

Many devices have floating vector addresses. The presence or 
absence of such floating address devices affects the addresses at 
which the other floating address devices in the system are 
installed. Floating address devices must be installed in a 
standard sequence . 

The standard UTll/ySBO vector address is 320. However. UTll/MSBOs 
can use floating addresses. If your VTll/'.'SBO is installed at 
nonstandard vector addresses, supply the correct value. The 
ranSe for valid responses is from 100 to 474. 

Respond with the vector address (octal) for the VTll or VS60. The range for 
valid responses is from 100 to 474. 

TERMINAL INTERFACE OPTIONS 

Do you want an introduction to terminal interface options (N)? 

ine introouctlon ext-'iciiiiij i/ne jl int/trriaces auPrOiucu w / i\i=i± 
and how SYSGEN assigns the terminal numbers. 

SYSGEN displays the following text if your response is YES. 

The terminal interface options allow you to select RT-11 support 
for the terminal interfaces installed in your system. RT-11 
supports a combination of serial asynchronous interfaces, which 
include the DLMU* DLUU-E, DLMll-F. DLUll-J. and the DLll 
series. It also supports DLll-E and DLMll-E interfaces, with 
modem capabilities. 



1-36 Preparing for System Generation 



The dialog asKs first for the riuiiiber of local DLll linest then 
the number of remote DLll lines. The total numher of lines is 
the sum of local and remote lines and must not exceed 8 lines. 
SYSGEN assigns physical unit numbers of the DLll lines first to 
local lines and then to remote lines. This assignment is 
permanent and you cannot change its order. 

After SYSGEN has established the number of lines of each typet it 
must establish the CSR and Mector addresses for each line. The 
first such question corresponds to the first local line (the 
console)* the second to the second local line* etc.» until all 
local lines are accounted for. At that pointi the next question 
applies to th-e first remote line» the second to the second remote 
line* e t c . t until all remote lines are accounted for. 

If your interfaces are DLll-W interfaces! they should be at REU E 
or higher. If they are not* an Endineerin3 Change Order (ECO DEC 
-0-LOG M785B-S0002) must be applied to the M785G module, The 
field service r e p r e s e n t a t i y e who installs your hardware should 
apply the ECO» if necessary. 

180. How many local DLll lines* including the console* are to be 
supported ( 1 ) ? 

Enter the total number of LOCAL DLll terminals included in the 
target configuration. Since the console is always a local DLll* 
the response is never less than 1. Do not include REMOTE DLll 
lines in this number. Remote DLll lines are specified in the next 
question. The ran3e for valid responses is from 1 to 8. 

181. How many remote DLll lines are to be supported ( ) ? 

Enter the total number of REMOTE DLll terminals included in the 
target o on f i 3u rat i on . Do not include LOCAL DLll lines in this 
number. This response must not be Greater than 7 . 

This response must not be greater than 7, and the sum of this response and 
the response to question 180 (local DLll lines) must be less than or equal to 
8. If the total exceeds this number, SYSGEN prints the following message: 

?SYSGEN-W-Exoeeded total number of valid DLll lines 

182. What is the CSR address for the <nth> DLll (nnnnnn)? 

Enter the address (octal) of the DLll interface. The ran3e for 
valid responses is from ISOOOO to 177570.- 

The field service representative who installs your "hardware system is re- 
sponsible for supplying you with a written record of addresses at which he 
or she installs each device. 

183. What is the vector for the <nth> DLll (nnn)? 

Enter the vector address (octal) of the DLll interface. The 
ranse for valid responses is from GO to 474. 

The next questions that SYSGEN asks depend on your responses to ques- 
tions 180 and 181. SYSGEN repeats questions 182 and 183, asking for the 
CSR and vector addresses for as many local interfaces as you specified in 
question 180 and for as many remote interfaces as you specified in question 



Preparing for System Generation 1—37 



181. Respond with the addresses for all the local interfaces before supplying 
the addresses for all the remote interfaces. Remember that the default re- 
sponse is in parentheses after the question. 

Default CSR and vector addresses for the next local DLll interfaces are as 
follows: 

CSR Address Vector Address 

176500 300 

176510 310 

176520 320 

176530 330 

176540 340 

176550 350 

176560 360 

Default CSR and vector addresses for the next remote DLll interfaces are 
as follows: 

CSR Address Vector Address 

175610 310 

175620 320 

175630 330 

175640 340 

175650 350 

175660 360 

175670 370 

184. Do v'01.1 want DZll or DZMll wu 1 1 i p 1 e x o r support (N)? 

You can select RT-11 support for one DZll-A or DZll-B eisht-line 
multiplexor with an additional DZll-C or DZll-D eisht-line 
multiplexor) for a maximum of IB lines. Or you can select one 
to four DZUll four-line multiplexors. Modem support is available 
on remote lines. but is limited to Bell 103 type modems or 
equivalent. RT-11 support for modems requires the modems to 
operate in auto-answer mode. Therefore, the "common carrier and 
clear to send" options must have been installed ( d u r i n S manufac- 
ture or installation). Type Y if your configuration includes a 
DZll or DZMll multiplexor. 

185. Do you want DZll multiplexor support (Y)? 

Type Y if your configuration includes a DZll multiplexor 

SYSGEN asks you this question only if you respond YES to question 184. If 
you respond NO, SYSGEN prints the message: 

DZMll four- line multiplexor support is assumed. 
18G. How many DZ multiplexors are to be supported (1)? 
Enter the number of DZ multiplexors in the target c on f i 3u r at i on . 

SYSGEN asks this question only if you respond YES to question 184. 



1-38 Preparing for System Generation 



The following dialog asks first for the number of local DZll or DZVll lines, 
then the number of remote lines. The total number of lines is the sum of 
local and remote lines. SYSGEN assigns physical unit numbers of the DZll 
or DZVll lines first to local lines and then to remote lines. This assignment 
is permanent and cannot be changed. 

187. How many local DZ lines are to be supported altogether (1)? 

Enter the total number (deoimal) of DZ lines that are local 
terminals. The ranSe for m a 1 i d responses is from to IB. 

188. How many remote DZ lines are to be supported altogether (0)? 

Enter the total number (decimal) of DZ lines that are remote 
terminals. The ran^e for valid responses is from to IB. 

The interface vectors and CSR addresses are assigned to the floating device 
region and vary with each installation. 

189. What is the CSR for the <nth> DZ multiplexor (nnnnnn)? 

Enter the CSR address for the <nth> DZ multiplexor. The valid 
ran3e is IBOOOO- 1 77570 . 

The field service representative who installs your hardware system is re- 
sponsible for supplying you with a written record of addresses at which he 
or she installs each device. 

190. What is the vector for the <nth> DZ multiplexor (nnn)? 

Enter the vector address for the <nth> DZ multiplexor. The valid 
rande is from BO to iXll\ , 

If the response to question 186 was greater than 1, SYSGEN requests the 
CSR and vector addresses for the second through fourth DZ multiplexers. 
Default values for these addresses are as follows: 

DZ Multiplexer CSR Address Vector Address 

2 160020 310 

3 160030 320 

4 160040 340 

191. What baud rate do you want your lines initialized to (300)? 

The lines must be initialized to a specific baud rate. You can 
select 9B00 » 4800* 2^00. 1200. 300. 150* or 110 baud. 

Respond with the specific baud rate at which you want your lines initial- 
ized. All DZll or DZVll lines must be initialized to the same baud rate. 
The default response to this question is 300. A response other than those 
listed above produces the message: 

7SYSGEN-E- Invalid baud rate 
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At this point, SYSGEN allows you to change any previous responses. How- 
ever, if no changes are necessary, processing continues with the creation of 
the SYSGEN.CND file. 

Do v u want to o h a n 3 e a n v of your responses ( N ) ? 

Responses have been obtained for all of the SYSGEN question 54 

Y ij are n w 3 i u e n an p p r t u n i t y to make in i n a r c h a n S e s to the 
monitor options which you h a u e selected or to r e m u e support for a 
d e 1.1 i c e ■ or add support for a d e m i c e 4 If you h a y e made a 1 a r S e 
number of errors in this SYSGEN session it is recommended that you 
restart the SYSGEN dialoS4 

Press (rH) if you do not wish to change any of your previous responses. If you 
wish to change one or more dialog responses, answer YES. SYSGEN contin- 
ues by asking the following questions. 

Do you want to h a n S e in n i t r / t e r iii i n a 1 option responses ( N ) ? 

You may m a K e c h a n S e s to most of the d i a 1 3 questions concerning 
the options to be assembled into the monitor. You may not h a n 3 e 
the monitor types to be B Y S G E N e d 4 A 1 s ) you may not add or r e m m e 
m u 1 1 i t e r m i n a 1 support. To m a K e these c h a n 3 e s i you must restart 
the SYSGEN dialog, 

If no monitor-related changes are to be made, SYSGEN inquires about 
changes to device-related answers. If monitor changes are to be made, SYS- 
GEN continues with the following questions. 

What question n u m b e i-' do y u want r e - a s K e d ? 

Respond with the number which precedes the question that you wish 
to have r e - a s f; e d . 

The monitor option questions which you may change are: 

a, SJ timer support 2O4 User command linKase 

54 Deyicetimeoutsupport 2I4 Highspeed rins buffer 

64 System I/O e rro r messases 22 4 K e '/ boa rd men i t r c omman d s 

7, Sys tern Job suppo rt 2B4 50 Hz olocK 

8. .SPCPS request 27 4 KWll-P as system clocK 
94 Global SCCA support 3O4 Startup command file 

1 1 4 A s y n c h r n u s t e r m i n a 1 s t a t u 5 3 1 4 F 1 a t i n S p i n t s u p p r t 

12 4 M u 1 1 i t e r m i n a 1 timeout support 324 Memory parity support 
134 Output buffer size 33. Power failure messaSe 
144 Input buffer size 34. Batch support 

154 4FETCH request under XM 35. ErrorloSSinS 

IB. Month and year rollover support ISO. Number of empty deyioe 

slots 
170. 1,'Tl l/i.'SBO Sraphios 

If y u d not w ant to modify any additional monitor p t i n 
r e p n s e s t type < R E T U R N > . 

Do you want to change your device support ( N ) ? 

Type "Y" if you want to remove 1 add* or modify support for any 
devices. 

Do you want to remove support for a n y device ( N ) ? 

Y u are n w 3 i m e n an opportunity to remove support for an y device 
for which support was requested. 
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If your response is YES, SYSGEN asks the following question. 

What device do v o u NOT want supported? 

If you p r e y i u s 1 y asked to have a d e m i c e supported) but y o u n o w 
do not want support for a device) type the two letter name for 
that d e M i e . 

Do you want a list of available d e y i o e s ( Y ) ? 

After you enter the two-letter device mnemonic, SYSGEN prints the mes- 
sage: 

< d e 1.1 i c e > will not be supported. 

Do you want to add support for any device or have the questions for 
any deuice re-asKed (N)? 

SYSGEN will SiMe you an opportunity to add support for both 
DIGITAL supported d e y i o e s and your own devices. Type " Y " if you 
want to add support for any d e u i o e or Change your response to a 
question relating to a d e v i o e . 

Do you want to add/wodify a DIGITAL supported device (Y)? 

Type "Y" if you want to add support for any DIGITAL supported 
device or have questions related to any such device r e - a s k e d . 

If you respond YES, SYSGEN prints the following: 

Type <ESCAPE><RETURN> for help. 

Type ?< return:;- to list all devices. 

Type .<RETLIRN> when device specification is complete. 

Enter the device name to a d d / m o d i f y C d d ] : 

Do you want to define or redefine any system conditionals (N)? 

Type "Y" if you want to define additional system conditionals. 
If you want to change the value of a conditional* redefine itt 
and it will assume the n e w v a 1 u e . 

^^^i^^it^^^^ ^^^^Vr^^^it ^^^^^^^^t^ ^it^^^^ ^^^ ^^^^^^it T^^ ^^^^-SrirTlr^^ii-^^ilr^^^^^ 

DEMICE ASSIGNMENTS AND SYSGEN CLEANUP 

When all responses have been given and no further changes are to be made, 
SYSGEN begins this phase by asking the following questions: 

What is t ri e n a m e of the source input device C x x n j ( d d n ) ? 

SYSTEM BUILD: 

The SYSGEN assembling and linking process requires a source input 
device and a binary output device* as well as an output device 
for monitor link maps. The name you specify can be either a 
Physical or losioal name (for example* RKl* DP4 * BLD * etc.). For 
more explanation, see the RT-11 SYSTEM GENERATION GUIDE. 
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Respond with the device and unit number for the device on which you want 
the system sources to reside during system generation. SYSGEN assigns 
the logical device SRC: to the device you specify. Then, the SYSGEN com- 
mand files use SRC: for source input. Review Section 1.2.5.1 if you are 
unsure of the answer. 

N h a t is the name of the binary output d e y i o e t x x n ] ( d d n ) ? 

SYSTEM BUILD: 

The SYSGEN a s s e w b 1 i n 3 and linking process requires a source input 
d e I.) i c e a n d a binary output d e y i c e » as well as a n o u t p u t d e u i c e 
for monitor 1 i n K maps. The name you specify can be either a 
Physical or logical name (for example* RKli DPi^ . BLD i etc.). For 
more explanation* see the RT-11 SYSTEM GENERATION GUIDE. 

Respond with the device and unit number for the device that you want to 
receive binary and system output. SYSGEN assigns the logical device BIN: 
to the device you specify. Then, the SYSGEN command files send to BIN: 
the .OBJ and system files output during the system generation process. 
This device can be the same as the source input device; it can also be an 
independent output device or a system device. In any case, there must be 
sufficient space for all the files. Review Section 1.2.5.1 if you are unsure of 
the answer. 

What is the name of the map output d e u i c e [ x x n 1 ( d d n ) ? 

SYSTEM BUILD: 

The SYSGEN a s s e w b 1 i n S and 1 i n K i n 3 process r e 1=1 u i r e s a source input 
d e M i e a n d a binary output d e u i c e * as well as a n u t p u t device 
for monitor 1 i n K maps. The name you specify can be either a 
physical or logical name (for example* RKl* DP4 » BLD* etc.). For 
more explanation* see the RT-11 SYSTEM GENERATION GUIDE. 



Respond with the device and unit number for the device that you want to 
list the link maps that result when you assemble and link the system 
components. SYSGEN assigns the logical device MAP: to the device you 
specify. You can specify the console terminal or a line printer. Or, you can 
build a file for the map listings by specifying the physical name of a block- 
replaceable device such as a disk. Usually, the binary output device is 
suitable for the map files as well. Note that if you submit an SPR to DIGI- 
TAL for a system that you created through the system generation process, 
you must include the link maps (and the file SYSGEN.CND) for that sys- 
tem. Review Section 1.2.5.1 if you are unsure of the answer. 

Do you want to retain the system DBJs (Y)? 

The indirect command files that the SYSGEN program Generates 
delete the object modules (from which the system is built) when 
the object modules are no longer needed. This measure s e r m e s to 
conserve d i s K space while the system is b e i n 3 built. H o w e u e r * the 
object modules are often useful later when you patch the system. 
If your output device has sufficient free space* you can elect to 
retain all system object modules for future use. 
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Respond YES if you have abundant mass storage (approximately 500 
blocks per monitor being built) and if you want to retain the system .OBJ 
files for later updating purposes. Note that DIGITAL distributes monitor 
updates in source form. If in doubt, respond NO. The default response to 
this question is YES. 

Do v'QLi want to retain the work files (Y)? 

S Y S G E N creates five files which are used for the system builds: 
These are the 3 indirect coimnand files (SYSGEN.BLDt SYSGEN,MON» 
and SYSGEN.DEM) and the 2 source conditional files (BYSGEN.CND 
and SYSGEN.TBL). If you wish to haue these files deleted after 
the systew build procedure* SYSGEN.BLDt is run i type "N" and 
these work files will not be retained. 

To build an entire s y s t e w » mount the source and binary y o 1 u m e s » 
copy the files SYSGEN.CND. SYSGEN.TBL* and the sources for any 
u s e r - s u p p 1 i e d device handlers to the source, volume* and type 
$@SYSGEN.BLD. To build Just the monitors* type $@SYSGEN . MON . 
To build Just the device handlers* type $@SYSGEN . DEV . For 
more information* read the RT-11 SYSTEM GENERATION GUIDE. 

END OF SYSGEN PROGRAM - 
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Figure 1-6: System Generation Worksheet 



Monitor Type 

□ 1 . SJ monitor (Y) 

□ 2. FB monitor (Y) 

□ 3. XM monitor (N) 

Monitor Options 
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D 26. 
27. 
O30. 
31. 
D32. 
D33. 
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35. 
D36. 
68. 
D69. 



SJ timer support (N) 
Device timeout support (N) 
Message on system I/O errors (Y) 
System job support (N) 
•SPCPS programmed request (N) 
Global SCCA support (N) 
Multiterminal support (N) 
Asynchronous terminal status (Y) 
Multiterminal timeout (Y) 

Output ring buffer size: (40) 

Input ring buffer size: (134) 

.FETCH request under XM (Y) 

Month and year date rollover (N) 

User command linkage (Y) 

High-speed ring buffer (N) 

All keyboard monitor commands (Y) 

Utility subset (Y) 

Language subset (Y) 

Minimal subset (Y) 

50 Hz clock (N) 

Programmable clock as system clock (N) 

Start-up indirect command file (Y) 

Floating point (N) 

Memory parity support (N) 

Power failure messages (N) 

BATCH support (N) 

Error logging (N) 

Number of units supported by error logging (10) 

Define other system conditionals (N) 

Enter system conditional and value: 

symbol = value 



Device Options 
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RD50/RD51 Winchester Disk 
RX01 Single-Density Diskette 
RX02 Double-Density Diskette 
RX50 Diskette (Professional 300) 
TU58 DECtape II 
PDT-1 1 Intelligent Terminal 
RF11 Disk 
RK05 Cartridge Disk 
RL01/RL02 Cartridge Disk 
RP11 Disk Pack 
RK06/RK07 Cartridge Disk 
TM11 (UNIBUS) Magtape 
TJU16 (MASSBUS) Magtape 
TS1 1 (UNIBUS) Magtape 
Card Reader 
Null Handler 
Line Printer 
Serial Line Printer 
MSCP Disk-Class Handler 
Logical Disk Handler 
Single-Line Editor Handler 



O 
O 
D 
D 
O 
D 
O 
D 
O 



SP Transparent Spooler Package Handler 

■XC Professional Communication Port 

XL DL(V)-11 Communication Ports 

DT ■ DECtape 

DS RJS03/04 Fixed-head Disk 

CT TA11 Cassette 

PC PC1 1 Paper Tape Reader/Punch 

PR PR1 1 Paper Tape Reader 

VM Virtual Memory Handler 



O 100. Second device controllers: 
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O101. 



RX11 (N) 
RX02 (N) 
TU58 (N) 



Double-density only RX02 support (N) 
Addresses for Peripheral Device Controllers 
(Questions 102 and 103) 
Controller CSR Vector 



(264) 

(270) 

(264) 

(270) 

(300) 

(310) 



IstRXII 


(177170) 


2nd RX1 1 


(177174) 


1stRX211 


(177170) 


2ndRX211 (177150) 


1stTU58 
2nd TU58 


(176500) 
(176510) 


D 104. 
D 105. 
O 106. 
O 107. 
O 108. 
O 110. 
O 120. 


No. of disk platters on RF1 1 controller: _ 
RJS03 (not RJS04) support (Y) 
No. of RL01/RL02 units: (2) 
RPR02 (not RPR02/RP03) support (N) 
No. of MSCP ports supported: (1) 
SPOOL flag page support (Y) 
File-structured magtape handlers (Y) 


D 
D 
D 


TM11 (Y) 
TJU16 (Y) 
TS11 (Y) 


D 121. 


No. of magtape units supported: 


D 
D 
D 


TM11 (2) 

TJU16 (2) 
TS11 (2) 




Addresses for TS11 Units 




(Questions 122 and 123) 


Unit 


CSR Vector 


1 
2 

3 
4 
5 
6 

7 
8 


(172522) (224) 
(172526) (300) 
(172532) (304) 
(172536) (310) 
(172542) (314) 
(172546) (320) 

(172552) (324) 

(172556) (330) 



D 130. 
O 131. 
O 132. 
D 133. 
D 134. 



.(1) 



Printer has nonstandard CSR/vector addresses (N) 

Nonstandard CSR address for printer: (177514) 

Nonstandard vector address for printer: (200) 

Professional 300 printer port support (N) 

CSR address for serial line printer: (176500) 



(continued on next page) 
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Figure 1-6: System Generation Worksheet (Cont.) 



□ 135. Vector address for serial line printer: (300) 

D 1 51 . CSR address for XL: (1 76500) 

D 152. vector address for XL: (300) 

n 1 60. No. of extra device slots: (0) 

Support for your own devices (N) 



Graphics Options 

D 170. VT1 1/VS60 graphics support (N) 

D 171. VS60 support (N) 

D 172. CSR address for VT1 1/VS60: (172000) 

D 1 73. Vector address for VT1 1 /VS60: (320) 

Terminal Interface Options 

D 180. No. of local DL11 lines: (1) 

D 181 . No. of remote DL1 1 lines: (0) 

CSR and Vector Addresses for Local and Remote DL1 1 
(Questions 182 and 183) 
Local DL1 1 Addresses Remote DL1 1 Addresses 

Lines CSR Vector CSR Vector 

1 _ 



2 (176500) (300) (175610) (310) 

3 (176510) (310) ■ (175620) (320) 

4 (176520) (320) (175630) (330) 

5 (176530) (330) (175640) (340) 

6 (176540) (340) (175650) (350) 

7 (176550) (350) (175660) (360) 

8 (176560) (360) (175670) (370) 

□ 184. DZ11 or DZV11 multiplexer support (N) 

□ 185. DZ1 1 multiplexer support (Y) 

□ 186. No. of DZ multiplexers: (1) 

□ 187. No. of local DZ lines: (1) 

□ 188. No. of remote DZ lines: (0) 

Addresses for DZ Muitiplexers 

(Questions 189 and 190) 
Unit CSR Vector 

1 _ 

2 _ 

3 _ 

4 _ 



(160010) 


(300) 


(160020) 


(310) 


(160030) 


(320) 


(160040) 


(330) 



□ 191 . Baud rate of lines: (300) 

Physical Device Selection and SYSGEN Cleanup 

□ Source input device: (ddn) 

□ Binary output device: (ddn) 

□ Map output device: (ddn) 

□ Retain system OBJs (Y) 

□ Retain work files (Y) 

Source Flies Required 
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Chapter 2 

Performing the System Generation Process on a 
Disk System 



To perform the system generation process on a disk system, perform the 
procedures summarized in the following list and described in Sections 2.1 
through 2.4. 

1. Run the program IND.SAV. 

2. Collect the appropriate files on the appropriate media. 

3. Assemble and link the monitor(s) and device handler(s). 

The following sections correspond to each of these four procedures and de- 
scribe the steps involved in each procedure. Chapter 3 describes the proce- 
dures for performing the system generation process on diskette configura- 
tions. 

2.1 Running the Program IND.SAV 

The first procedure in the system generation process is to run the SYSGEN 
program and answer the dialog questions. 

Make sure that the files IND.SAV and SYSGEN.COM are on your system 
device and that the system device is not write-protected. The .COM files 
can reside on another volume (except magtape) as long as the volume has 
2000 free blocks and you assign the default DK: to that unit. The steps in 
this section assume that these files are on the system volume. 

Use the following command: 

RUN IND.SAy SYSGEN. COM® 

(The dialog prints.) 
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Use the worksheet (Figure 1-6) you compiled when you read Chapter 1, 
and respond to each dialog question. The dialog asks a question, waits for 
your response, and resumes at the appropriate point. SYSGEN may skip 
some questions, depending on the responses you give. If you are not famil- 
iar with the Version 5 SYSGEN dialog, type dc) at the end of any question 
to print an explanation. Type (ED to terminate each response. 

Parentheses at the end of each question contain the default response. To 
select that default response, simply type (Hi). You can terminate SYSGEN 
by typing (ctrl/c) . 

If you type ( ctrl/o ) whenever an explanation is printing, SYSGEN stops 
printing the explanation, reprints the question, and waits for your re- 
sponse. Note, however, that you should not type (ctrl/o] while SYSGEN is 
printing a question; in this case, the end of the question is truncated, and 
you will be unable to read the question, but SYSGEN waits for a response. 

If you give an inappropriate response to a dialog question, SYSGEN prints 
an error message and repeats the question. If you receive any other error 
message while running SYSGEN, check the RT-11 System Message Man- 
ual for that message. 

If you want to change a response to a question, make a note of it, and 
continue through the dialog. After you have answered all questions, SYS- 
GEN will ask you if you wish to change any responses. Most responses can 
be changed; however, you cannot change what monitor(s) are being built, 
nor can you add or rem-ove multiterminai support. To make these major 
changes, you must rerun SYSGEN. 

There is no need to edit the file SYSGEN.CND to include system condition- 
als not addressed in the SYSGEN dialog. Questions 68 and 69 in the SYS- 
GEN dialog let you define any system conditionals found in Appendix C. 
The procedure for defining system conditionals is located in Section 1.2.4. 

After you respond to the final system generation question, the end message 
prints on the terminal and control returns to the monitor. 

2.2 Coliecting the Appropriate Files on the Appropriate Media 

At this point, prepare to copy files to devices according to the arrangement 
you planned in Section 1.2.5. Gather distribution backup copies that, con- 
tain the source files you will need. Make sure the command files SYS- 
GEN.MON and SYSGEN.DEV (and SYSGEN.BLD, if you can use it) are on 
device DK:. 

2.3 Assembling and Linking the Monitor(s) and Device Handlers 

SYSGEN creates command files to assemble and link the monitor(s) and 
device handlers you are generating. These command files consist of assem- 
bly and link commands (plus file deletion commands if you chose not to 
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retain the .OBJ files). You can execute the command files as they are, or 
you can alter them, as long as the final commands perform the required 
fimctions. For example, you might want to alter the command files as fol- 
lows: 

1. You can change the map output device to a block-replaceable device 
and create a file instead of a listing. You can suppress the link maps by 
sending the output to the null device, NL:. However, you will need to 
include a link map and answer file listing with any SPR you might 
submit to DIGITAL for a monitor created by SYSGEN. DIGITAL 
recommends saving the link maps in a file on a disk, if possible, so they 
will not be misplaced. You will also need the link maps if you wish to 
apply software customizations. 

2. You can change the devices on which individual source or binary files 
are to reside to optimize mass storage use. 

You can choose the indirect command file(s) you want to use to build the 
system. SYSGEN creates SYSGEN.MON and SYSGEN.DEV. If you want 
to build both the handlers and the monitors in the same operation and you 
have sufficient free storage, use SYSGEN.BLD, a distributed indirect com- 
mand file that invokes SYSGEN.MON and SYSGEN.DEV. On the other 
hand, if you want to build the handlers separately from the monitors, use 
SYSGEN.MON to build the monitors and SYSGEN.DEV to build the han- 
dlers. 

Edit the indirect command files at this point, if necessary. Then proceed to 
the section that describes the procedure you need to use: 

9 Using SYSGEN.BLD to build the system (Section 2.3.1) 

® Using SYSGEN.MON and SYSGEN.DEV to build the system (Section 
2.3.2) 

9 Building handlers separately (Section 2.3.3) 

2.3.1 Using SYSGEN.BLD to Build tlie System 

Generally, if you have sufficient space on the device BIN: (approximately 
2000 free blocks), you should use SYSGEN.BLD to build the system. Make 
sure that the disks to be used as SRC: and BIN: are mounted. Refer to 
Section 1.2.5 to review your plans for the system build procedure. 

Copy the appropriate source files to the device that is to serve as SRC:. In 
the following command, xxn: is your distribution backup device, unless you 
put source files on one of your working system volumes when you installed 
RT-11, and yyn: is SRC:. 

, COPY xxn :f i Inam.MAC v y n : f i 1 n am . MAC®) 



Performing the System Generation Process on a Disk System 2—3 



Then, copy SYSGEN.CND and SYSGEN.TBL to the source disk, if neces- 
sary. In the following command, xxn: is the device that contains SYS- 
GEN.CND and SYSGEN.TBL, and yyn; is the device you specified as SRC: 
near the end of the SYSGEN dialog. 



.COPY xxn: SYSGEN.CND y yn : SYSGEN . CND® 
.COPY xxn:SYSGEN.TBL y yn : SYSGEN . TBL® 



Now, consolidate the free space on the binary disk. This step is very impor- 
tant if you have space problems. In this command, zzn: is the device you 
specified as BIN: near the end of the SYSGEN dialog. 



.SQUEEZE zsnrdi) 

z z n : / S q u e e z e i Are you sure' 



Finally, invoke the indirect command file SYSGEN.BLD. Each command 
line in SYSGEN.BLD, SYSGEN.MON, and SYSGEN.DEV logs on the ter- 
minal as the system executes the command. The following example shows 
terminal output similar to the output that will print on your terminal when 
you invoke SYSGEN.BLD. 

,$@SYSGEN.BLD(1!) 

$@SYSGEN.MON 

ASSIGN DLl SRC 

ASSIGN DLO BIN 

ASSIGN DLO MAP 

ASSIGN DLO OBJ 

MACRO/OBJ: OBJ :KMFB SRC: ( FB+SYSGEN . CND+EDTGBL+KMON+KMOMLY ) 

MACRO/OBJ:OBJ:RMFB SRC: ( FB+SYSGEN . CND+EDTGBL+USR+RMONFB ) 

MACRO/OBJ:DBJ:TBFB SRC: ( FB+SYSGEN . CND+EDTGBL+SYSGEN . TBL ) 

MACRO/OBJ:OBJ:BTFB SRC: ( FB + SYSGEN . CND + EDTGBL + BSTRAP ) 

MACRD/OBJ:OBJ:MEFB SRC: ( FB+SYSGEN . CND+EDTGBL+MTTEMT ) 

MACRD/OBJ:OBJ:MIFB SRC: ( FB + SYSGEN . CND + EDTGBL + MTTINT ) 

LINK/EXE:DBJ:RT11FB.SYG/B0U: 1000/ PROMPT/MAP : MAP : RT 11 FB OBJ:BTFB 

DBJ:RMFB »KMFB (MEFB .MIFB »TBFB// 

OVLYO 

$@SYSGEN.DEM 

ASSIGN DLl SRC 

ASSIGN DLO BIN 

ASSIGN DLO OBJ 

MACR0/0BJ50BJ:BA SRC: ( SYSGEN , CND+BA ) 

LINK/EXE:BIN:BA.SYG 0BJ:BA 

MACRO/OBJ: OBJ :DX SRC; ( SYSGEN . CND+DK ) 

LINK/EXE:BIN:DK.SYG OBJ:DX 

MACRO /OBJ: OBJ :RK SRC: ( SYSGEN . CND+RK ) 

L I NK /EXE : B I N : RK . SYG OB J : RK 

MACRO/OBJ:OBJ:LP SRC: ( SYSGEN , CND+LP ) 

LINK/EXE:BIN:LP.SYG OBJ:LP 



The most common errors that can occur during the build process are listed 
in Table 2-1. 
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Table 2-1: System Build Errors 



Type of Error 



Cause* 



Assembly errors 



?MACRO-F-File not 
found DEV.-FILNAM.TYP 

?MACRO-F-Device 
full DEV: 

?MACRO-F-I/0 error 
on workfile 



?MACRO-F-I/0 error 
on DEV.-FILNAM.TYP 



Incorrect or conflicting responses to SYSGEN dia- 
log. 

Reexamine your responses to SYSGEN. Often, 
reading the conditional files helps you spot er- 
rors. 

If the SYSGEN responses seem correct, make 
sure that you have the proper versions of the 
source files on the source disk. Check that you 
have not introduced an error if you edited the 
source files. Compare the files on the source disk 
to the originals in the distribution. 

Failure to copy dev:filnam.typ to source disk,or fail- 
ure to include all necessary source modules on disk. 

Insufficient space on binary output device to accom- 
modate all output files. 

Insufficient space on default output device. Check 
the following possibilities: 

You did not squeeze the default device before 
starting the build. Try squeezing it and rebuild- 
ing. 

Try rerunning SYSGEN to specify not retaining 
.OBJ files and then rebuild. Try deleting other 
unnecessary files on the binary device (but be 
sure they are unnecessary). 

If all these techniques fail, you must build the 
system manually, entering the commands indi- 
vidually and building one component at a time. 
Refer to Chapter 3. 

Bad volumes or write-protected devices. 
If the volume is bad, try another. 
If the device is write-protected, enable it. 



* If you encounter an error you cannot explain or correct, refer to the RT-11 System Mes- 
sage Manual; if you still cannot resolve the problem, send an SPR to DIGITAL with a 
listing of the answer files and link maps. 

Once you have built the system, copy and store the answer files, and if 
possible, the conditional, command, and output files from the generation 
process. You should retain at least the answer files, if you use a generated 
monitor, since all SPRs must be accompanied by a listing of these files (as 
well as link maps). If you keep the object files, you can reassemble a partic- 
ular component and relink manually, if necessary. 
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The .SYG files that result from the system build are masters for your gen- 
erated system and you should preserve them. Refer to the appropriate in- 
stallation chapter in the RT—11 Installation Guide, and perform the proce- 
dures to install the generated system. Rename .SYG files, monitors and 
handlers, to .SYS. You can also rename the monitor to distinguish it from 
standard monitors. You will have to copy the bootstrap for the generated 
monitor to your system device, if you want that monitor to boot. Note that 
you can always identify a user-generated monitor by the (S) that prints in 
the boot message. 

2.3.2 Using SYSGEN.MON and SYSGEN.DEV to Build the System 

If you use SYSGEN.MON and SYSGEN.DEV to build the system, you need 
approximately 2000 free blocks on device BIN:. Make sure that the disks 
you planned to serve as SRC: and BIN: are mounted. Refer to Section 1.2.5 
to review your plans for the system build procedure. 

Copy the appropriate source files for building the monitor(s) to the device 
that is to serve as SRC:. In the following command, xxn: is your distribu- 
tion backup device, unless you included the source files in your working 
system, and yyn: is SRC:. 

.COPY xxri! f ilriam.MAC yvn ; f i Iriaw . MAC® 



Then, copy SYSGEN.CND and SYSGEN.TBL to the source disk. In the 
following command, xxn: is the device that contains SYSGEN.CND and 
SYSGEN.TBL, and yyn: is the device you specified as SRC: near the end of 
the SYSGEN dialog. 

.COPY xxrisSYSGEN.CND yyn : SYSGEN . CND® 
.COPY xxnsSYSGEN.TBL yyn : SYSGEN . TBL® 



Now, consolidate the free space on the binary disk. In this command, zzn: is 
the device you specified as BIN: near the end of the SYSGEN dialog. 

.SQUEEZE zznsdS) 

zzn : /Squeeze ! Are you sure? YES) 



Sal, lliVUi^C mc Iliu.ii cut k^uiiiiiicaxn-i mc; k.7 X OvjiijJ."* .iVxVyii uu- u\xi.i.\x uj.xt^ aj.x^i.*a 

tor(s). The currently running monitor logs the commands on the terminal 
as it executes them. The following example shows terminal output similar 
to the output that will print on your terminal when you invoke SYS- 
GEN.MON. 
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.$@SYSGEN.MON(lT) 
ASSIGN DLl SRC 
ASSIGN DLO BIN 
ASSIGN DLO MAP 
ASSIGN DLO OBJ 

MACRO/aBJ:aBJ:KMFB SRC: < FB+SYSGEN . CND+EDTGBL+KMON+KMOULY ) 
,MACRO/OBJ:OBJ:RMFB SRC: ( FB+SYSGEN , CND+EDTGBL+USR+RMONFB ) 
MACRO/DBJ:OBJ:TBFB SRC; ( FB+SYSGEN , CND+EDTGBL+SYSGEN . TBL ) 
MACRQ/OBJ:OBJ:BTFB SRC: ( FB+SYSGEN . CND+EDTGBL+BSTRAP ) 
MA.CRO/OBJ:OBJ:MEFB SRC: ( FB + SYSGEN , CND + EDTGBL + MTTEMT ) 
MACRO/OBJ:aBJ:MIFB SRC: ( FB + SYSGEN . CND + EDTGBL + MTT I NT ) 
LINK/EXE:GBJ:RT11FB.SYG/B0U: 1 000/ PROMPT/MAP : MAP ; RT 11 FB GBJ:BTFB 
OBJ:RMFB »KMFB»MEFB.MIFBtTBFB// 
OULYO 



The most common errors that can occur during the build process are listed 
in Table 2-1. 

Now, delete all the source files that you needed to build the monitor(s) fi-om 
SRC:. Do not delete SYSGEN.CND or SYSGEN.TBL. In the following com- 
mand, yyn: is SRC:, and aaaaaa is the file name of the source file. 



.DELETE v'VM-i: aaaaaa, MACdB 



Then, copy to SRC: the source files that were used for building the han- 
dlers. In the following command, xxn: is your distribution backup device, 
yyn: is SRC:, and aa is the file name of the device handler source file. 



COPY xxn:aa.MAC y vii : aa . MAC® 



.COPY xxn:2Z,MAC yyn:zz.MAC@D 



Finally, invoke the indirect command file SYSGEN.DEV to build the de- 
vice handlers. The monitor logs the commands on the terminal as it exe- 
cutes them. The following example shows terminal output similar to the 
output that will print on your terminal when you invoke SYSGEN.DEV. 



. $@SYSGEN,DEU(l!l 
ASSIGN DLl SRC 
ASSIGN DLO BIN 
ASSIGN DLO OBJ 

MACRO/OBJ:OBJ:BA SRC: ( SYSGEN . CND + BA ) 
LINK/EKE:BIN:BA.SYG OBJ:BA 
MACRO/OBJ: OBJ :D)< SRC: ( SYSGEN . CND + DK ) 
LINK/EXE:BIN:DX,SYG OBJ:DX 
MACRO/OBJ:OBJ:RK SRC: ( SYSGEN . CND + RK ) 
LINK/EXE:BIN:RK.SYG OBJ:RK 
MACRO/OBJ:OBJ:LP SRC: ( SYSGEN . CND+LP ) 
LINK/EXE:BIN:LP.SYG OBJ:LP 
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The most common errors that can occur during the build process are listed 
in Table 2-1. 

Once you have built the system, copy and store the conditional, command, 
and output files from the generation process, if possible. You should retain 
at least the link maps and answer files, if you use a generated monitor, 
since listings of these files must accompany all SPRs. If you keep the object 
files, you can reassemble a particular component and relink manually, if 
necessary. 

Preserve the .SYG files that result from the system build; they are masters 
for your generated system. 

Refer to the appropriate installation chapter in the RT-11 Installation 
Guide, and perform the procedures to install the generated system. Rename 
.SYG files, monitors and handlers, to .SYS. You can also rename the moni- 
tor to distinguish it from standard monitors. You will have to copy the 
bootstrap for the generated monitor to your system device, if you want that 
monitor to boot. Note that you can always identify a user-generated moni- 
tor by the (S) that prints in the boot message. 

2.3.3 Building Handlers Separately 

To keep the monitor as small as possible, you may want to build a monitor 
with only a few device slots, or build many device handlers to go along with 
that monitor but use only a few devices at a time. When you select a device 
during the SYSGEN dialog, SYSGEN allocates a slot for it in the monitor 
device tables and adds commands to SYSGEN.DEV that build it. To build 
device handlers separately, you need to run SYSGEN twice. 

First, execute SYSGEN, selecting monitor options and support for the few 
devices for which you want to allocate slots. Use the resulting conditional 
and command files to build the basic system. Then, rerun SYSGEN, speci- 
fying the identical monitor options but selecting only the additional de- 
vices. Use the version of SYSGEN.DEV created during the second SYS- 
GEN session to build the additional handlers. Discard SYSGEN.MON and 
SYSGEN.BLD files from the second SYSGEN run. 

You can usa one of two procedures to install additional device handlers for 
the devices you want to use during a particular session. 

1. Use the REMOVE and INSTALL commands. 

2. Use the bootstrap routine's automatic installation capability by simply 
replacing device handlers on the system device and rebooting. 

Refer to Section 2.7.11 of the RT-11 Installation Guide for a description of 
both procedures. 
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Chapter 3 

Performing the System Generation Process on a 
Small System 



If you intend to perform the system generation process on an RXOl, RX02 
or RX50 system, follow the procedures in this chapter. If your system has 
two diskette units, you can perform the system generation process, but it is 
not recommended. It takes a long time and is not automated. If you want to 
attempt the procedures, follow all the steps in this chapter very carefully. 

Do not try to generate a system for a target configuration that is different 
from the diskette configuration on which you are performing the system 
generation process. The procedures in this chapter may not work if you try 
to generate support for many devices. 

3.1 Creating a Working System for This Process 

Begin the system generation process by creating a system diskette with the 
SJ monitor, or the FB monitor if you are using a Professional 325 computer. 

Include the following files (from your working system and distribution 
backups) on the system diskette: 

RTllSJ.SYS or RTllFB.SYS 

xx.SYS (DX.SYS, DY.SYS, or DZ.SYS) 

SWAP.SYS 

TT.SYS 

LP.SYS (if appropriate) 

IND.SAV 

SYSGEN.COM 

DIR.SAV 

PIP.SAV 

DUP.SAV 

Be sure to squeeze the diskette and copy the bootstrap to it. Then boot this 
system. 
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3.2 Running the Program SYSGEN.COM 

This procedure describes' building only one monitor (and its associated de- 
vice handlers) at a time. Run SYSGEN.COM once for each monitor you 
need. Each time you run SYSGEN, answer YES to only one of the questions 
that offer the various monitors. Follow the procedure in this section to build 
that monitor and its associated handlers. Then run SYSGEN again to 
choose another monitor. Repeat the procedure in this section to build the 
monitor and handlers, and so on. 

Use the following command to run the SYSGEN program. 

•RUN IND.SAU SYSGEN. COM® 

(The dialog prints.) 

Use the worksheet (Figure 1-6) you compiled when you read Chapter 1, 
and respond to each dialog question. The dialog asks a question, waits for 
your response, and resumes at the appropriate point. SYSGEN may skip 
some questions, depending on the responses you give. If you are not famil- 
iar with the Version 5 SYSGEN dialog, type dEKUl) at the end of any ques- 
tion to print an explanation. Type <M) to terminate each response. 

Parentheses at the end of each question contain the default response. To 
select that default response, simply type (rH). You can terminate SYSGEN 
by typing (ctrl/c) . 

If you type [ctrl/o) whenever an explanation is printing, SYSGEN stops 
printing the explanation, reprints the question, and waits for your re- 
sponse. Note, however, that you should not type (ctrl/o) while SYSGEN is 
printing a question; in this case, the end of the question is truncated, and 
you will be unable to read the question, but SYSGEN waits for a response. 

If you give an inappropriate response to a dialog question, SYSGEN prints 
an error message and repeats the question. If you receive any other error 
message while running SYSGEN, check the RT—11 System Message Man- 
ual for that message. 

Answer the system build questions near the end of the dialog with the 
names of devices in your configuration. Since you will read the indirect 
command files (not run them), it does not matter which device is SRC:, 
BIN:, or MAP:. 

If you want to change a response to a question, make a note of it, and 
continue through the dialog. After you have answered all questions, SYS- 
GEN will ask you if you wish to change any responses. Most responses can 
be changed; however, you cannot change what monitor(s) are being built, 
nor can you add or remove multiterminal support. To make these major 
changes, you must rerun SYSGEN. 

There is no need to edit the file SYSGEN.CND to include system condition- 
als not addressed in the SYSGEN dialog. Questions 68 and 69 in the SYS- 
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GEN dialog let you define any system conditionals found in Appendix C. 
The procedure for defining system conditionals is located in Section 1.2.4. 

After you respond to the final question, the end message prints on the 
terminal, and control returns to the monitor. 

When SYSGEN completes, the following new files appear in your system 
diskette's directory. (See Figure 1-2.) 

SYSGEN.CND 

SYSGEN.TBL 

SYSGEN.BLD 

SYSGEN.MON 

SYSGEN.DEV 

SYSGEN.ANS (optional) 

Using the following command, examine your directoi-y to make sure that 
these files have been created. 

. DIRECTORYdl) 

(The directory prints.) 

3.3 Collecting the Appropriate Files on the Diskettes 

Because you cannot fit all the files required to build your system on two 
diskettes, you must arrange the files so that you can copy them to your 
system diskette one at a time and perform the component assemblies sepa- 
rately. First, you will need to study the indirect command files to identify 
the files you will need for system build. Then, you will need to create four 
diskettes to hold the various files during the build procedure. 

3.3.1 System Build Indirect Command Flies 

To ascertain the files you need, list the files SYSGEN.MON and SYS- 
GEN.DEV on the terminal or line printer. These files contain the names of 
all the source files you need to perform the assemblies to build the system. 
.They also contain all the keyboard monitor commands that assemble and 
link it. 

On terminal 

.TYPE SYSGEN. MONISH) 
.TYPE SYSGEN. DEUdU 

On line printer 

.PRINT SYSGEN. MONdD 
.PRINT SYSGEN. DEUdll 
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Figure 3-1 shows an example of SYSGEN.MON and SYSGEN.DEV (for a 
multiterminal foreground/background system). Certain lines in this exam- 
ple are numbered for reference. For example, lines 1, 2, 3, and 4 show the 
commands that assign various devices to SRC:, BIN:, MAP:, and OBJ:. 

Figure 3-1: Sample SYSGEN.MON and SYSGEN.DEV Files 



1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 



14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 



BYSGEN EDIT LEUEL = 1 

SYSGEN.MON CREATED 



19-0ct-8: 



16:28:35 



THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY ONLY BE USED 
OR COPIED IN ACCORDANCE NITH THE TERMS OF SUCH LICENSE. 



COPYRIGHT (c) 1982. 1983 B^ 
ALL RIGHTS RESERVED. 



DIGITAL EQUIPMENT CORPORATION. 



ASSIGN DLl SRC 

ASSIGN DLO BIN 

ASSIGN DLC 

ASSIGN DLC 

MACRO/OBJ 

MACRO/OBJ 

MACRO/OBJ 

MACRO/OBJ 

MACRO/OBJ 

MACRO/OBJ 



MAP 
OBJ 
iOBJ: 
lOBJ: 
lOBJ: 
iDBJ: 



( FB + SYSGEN . CND + EDTGBL + KMON + KMOULY ) 

(FB+SYSGEN.CND+EDTGBL+USR+RMONFB) 

(FB+SYSGEN.CND+EDTGBL+SYSGEN.TBL) 

( FB+SYSGEN . CND+EDTGBL+BSTRAP ) 

(FB+SYSGEN.CND+EDTGBL+MTTEMT) 

(FB+SYSGEN.CND+EDTGBL+MTTINT) 

LINK/EXE: BIN ;RT11FB.SYG/BDU: 1 000 /PROMPT/MA P : MAP : RT 1 1 FB OBJ: 

OBJ:RMFB .KMFB .MEFB »MIFB .TBFB// 

OMLYO 



KMFB SRC: 
RMFB SRC: 
TBFB SRC: 
BTFB SRC: 
OBJ:MEFB SRC: 
OBJ:MIFB SRC: 



BTFB 



SYSGEN EDIT LEVEL = 1 

SYSGEN.DEV CREATED 



19-Oct-B: 



16:28:35 



THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY ONLY BE USED 
OR COPIED IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE, 

COPYRIGHT (c) 1982. 1983 BY DIGITAL EQUIPMENT CORPORATION. 
ALL RIGHTS RESERVED. 

ASSIGN DLl SRC 
ASSIGN DLO BIN 
ASSIGN DDLO OBJ 

MACRO/OBJ:OBJ:BA SRC: ( SYSGEN . CND+BA ) 
LINK/EXE:BIN:BA.SYG OBJ:BA 
MACRO/OBJ:OBJ:DX SRC: ( SYSGEN . CND+DX ) 
LINK/EXE:BIN:DX.SYG OBJ:DX 
MACRO/OBJ;OBJ:DL SRC: ( SYSGEN . CND+DL ) 
LINK/EXE:BIN:DL.SYG OBJ:DL 
MACRO/OBJ:OBJ:LP SRC: ( SYSGEN . CND+LP ) 
LINK/EXE:BIN:LP.SYG OBJ:LP 



Line 5 assembles the keyboard monitor. In this command line, 
MACRO/OBJ:OBJ: invokes the MACRO-11 assembler and specifies the 
output device for the object file that results from this operation. OBJ: is the 
device; note that line 2 assigns DLO: to OBJ:. Therefore, if you were to 
invoke SYSGEN.MON, the object file would go to DLO:. 

KMFB is the output file name. The file type is .OBJ, since MACRO creates 
object files by default. 
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On the input side of the command string, SRC: is the input device. Line 1 
assigns DLl: to SRC:. The parentheses contain the source files to be assem- 
bled. The source input files in this command string are FB.MAC, SYS- 
GEN.CND, EDTGBL.MAC, KMON.MAC and KMOVLY.MAC. The system 
assumes .MAC files as input to MACRO. Because the files are separated by- 
plus signs (rather than commas), one object file (KMFB.OBJ) results firom 
this assembly. 

SYSGEN.MON contains commands similar to the ones in lines 9 and 10 
only if you are generating a multiterminal system. 

Lines 11, 12, and 13 link the monitor object modules. In the command 
string, LINK invokes the linker. The option /EXE:0BJ:RT11FB.SYG speci- 
fies a device (OBJ:) and file specification (RTllFB.SYG) for the executable 
file that results from this operation. The monitor created by this example is 
RTllFB, but it has the .SYG file type, since it is created through the 
system generation process. The option /BOU:1000 specifies the address 
boundary on which LINK should start a program section to be named when 
LINK asks for its name (line 13). /PROMPT allows additional lines to be 
entered when the command string is too long to fit on one line. If you were 
to execute SYSGEN.MON, the system would prompt with an asterisk (*) at 
line 12. Additional lines can be entered before the double slashes (//), which 
indicate the end of the command string. 

On the input side of the command, OBJ: is the input device. The default 
LINK input file type is .OBJ. BTFB is the object file BTFB.OBJ that re- 
sults from the assembly performed at line 8; RMFB is the object file 
RMFB.OBJ that results from the assembly performed at line 6; and so on. 

Line 13 is the name of the program section whose address boundary is 
specified in the /BOU:1000 option. This line responds to the system prompt 
Boundary section'?, which would appear (if you were to execute SYS- 
GEN.MON) once the command string is completed. 

The command lines in the versions of SYSGEN.MON and SYSGEN.DEV 
that result from your SYSGEN session are variations of the commands in 
Figure 3-1. You can identify all the source files that you will need for your 
assemblies if you study the command files. 

When you actually assemble components, you will type each command line 
in the indirect command file. Before typing the command, however, you 
must copy to the system diskette the source files you need to perform that 
assembly. When you type the command, you must substitute specific de- 
vices (DXO:, DYO:, or DZO:) for SRC: and (DXl:, DYl:, or DZl:) for BIN:. 
You will not make the device assignments in lines 1, 2, 3, 4, 14, and 15. 

3.3.2 Creating System Build Disl<ettes 

Create four diskettes for the system build procedure. SYSGEN.CND and 
SYSGEN.TBL should be on your system diskette (since you have run SYS- 
GEN). The other source files are on your backup distribution diskettes. 
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When you initialize each diskette, give it an identifying volume ID. For 
example, to initialize Diskette 1, type: 



.INITIALIZE/BAD/MOL x x 1 : (H) 

X X 1 : / I n i t i a 1 i 2 e i Are you sure? YE 

?DUP-I-No bad blacks detected xxl 

i.'olume ID? DISKETTE 1®) 

Owne r? iH) 



Then, you can easily identify each diskette. For example, you can type: 



.DIRECTDRY/UOL(i 
DISKETTE 1 



3.3.2.1 Diskette Contents — The four diskettes for this procedure should 
contain the files (but only the files) in the following lists. 

Diskette 1 

The system diskette for the assembly procedure should contain: 

RTllSJ.SYS or RTllFB.SYS 

xx.SYS (DX.SYS, DY.SYS, or DZ.SYS) 

SWAP.SYS 

TT.SYS 

LP.SYS . 

MACRO.SAV 

SYSGEN.CND (from the SYSGEN session you just performed) 

PIP.SAV 

DUP.SAV 

DIR.SAV 

SYSMAC.SML 

yy.MAC (yy is the monitor you are building: SJ, FB, or XM) 

EDTGBL.MAC 

KMON.MAC 

Diskette 2 

The second diskette will store two .MAC source files for the second assem- 
bly. It will also receive .OBJ files produced during assemblies. It should 
contain: 

USR.MAC 

RMONxx.MAC (xx is SJ or FB) 

Diskette 3 

The third diskette will store most of the .MAC source files for the assem- 
blies until they are needed on the system diskette. It must contain: 
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xx.MAC (DX.MAC or DY.MAC) 

SYSGEN.TBL (from the SYSGEN session you just performed) 

BSTRAP.MAC 

zz.MAC (zz is device name for support specified during SYSGEN) 



zz.MAC (zz is device name for support specified during SYSGEN) 
Other source files, except KMOVLY.MAC (Refer to SYSGEN.MON and 

SYSGEN.DEV.) 
LINK.SAV 

Diskette 4 

The fourth diskette should contain the KMON overlays for the KMON 
assembly. It -will receive the KMON object file, and you vi^ill copy the other 
object files to it as you assemble them on Diskette 2. Diskette 4 should 
contain: 

KMOVLY.MAC 

3.3.2.2 Copying the Files — Review the installation procedures in the 
RT-11 Installation Guide, if necessary, when you create these diskettes. If 
you run out of room when you create a diskette, squeeze the diskette to 
consolidate free space. When you copy files from nonbootable diskettes, use 
the COPY/SYSTEM/WAIT command. For example, type: 

• CDPY/SYSTEM/WAIT xxl :f ilnaw. tvp xxOif ilnaw. typdl) 
Mount input y o 1 u m e in xxl:! Continue? 

Place the diskette that contains the file you want to copy in Unit 1. 

Y® 
Mount output volume in x x : ! Continue? 

Replace the system diskette in Unit with the diskette to which you want 
to copy filnam.typ. 

Yds 

Mount s y 5 t e (ii u o 1 u w e in x x : i Continue? 

Replace the newly created output diskette in Unit with the system disk- 
ette. 



Do not forget to copy the bootstrap to Diskette 1 and to squeeze the disk- 
ettes to consolidate free space. Do not use diskettes with bad blocks. Use 
the hardware bootstrap to boot Diskette 1, and set the date and time. 
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3.4 Assembling and Linking the Monitor(s) and Device Handlers 

Now that your files are arranged on the four diskettes, you can enter the 
command lines to assemble and link the components. First, assign the logi- 
cal name WF: to Unit 1 (RXOl or RX02). The MACRO-11 assembler uses a 
work file during some assemblies. 

, ASSIGN xxl : WF:®) 



3.4.1 Assembling Files 

Insert Diskette 4 in Unit 1. Refer to your listing of SYSGEN.MON for the 
first command. Ignore the command lines that begin with ASSIGN. The 
source files required for this assembly are on Diskettes 1 and 4. 

When you type the command, you will substitute DXn: or DYn: for OBJ: 
and SRC: as shown in the following examples. You must also make other 
adjustments to this first command line because of the special size con- 
straints of the keyboard monitor assembly (always the first assembly). For 
example, you must add the /ALLOCATE:150 option to the MACRO com- 
mand, and you must indicate that KMOVLY resides on the diskette in 
Unit 1. 

The command varies according to the type of monitor being built. For ex- 
ample, if you were building an FB monitor, the first assembly command 
line in SYSGEN.MON would be Example 1 below; you would type the 
command line displayed in Example 2. Study all these examples and your 
SYSGEN.MON listing; then execute the first assembly. Press (M) at the end 
of each line. 

Example 1 

MACRO/OBJ:OBJ:KMFB SRC: ( FB+SYSGEN , CND+EDTGBL+KMON+KMOMLY ) 

Example 2 

MACRD/DBJ:xxl : KMFB/ ALLOCATE : 150 xxO: ( FB + SYSGEN . CND + EDTGBL + KMQN ).+ xk 1 :KMOULY(l!) 

NOTE 
Refer to Table 3-1 if errors occur during assemblies. 

The first assembly may take as long as half an hour. The exact amount of 
time depends on the amount of memory — the more memory in your con- 
figuration, the faster the assembly. 

When the system completes the assembly, delete the source files KMON 
from Diskette 1 and KMOVLY from Diskette 4. Leave SYSGEN.CND and 
EDTGBL on Diskette 1; you need SYSGEN.CND for all assemblies and 
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EDTGBL for most assemblies. After you delete these files, squeeze Diskette 
1 to consolidate free space. 



. DELETE xxO:KMDN.MACE) 

. DELETE xxl :KMOMLY.MAC(lll 

. SQUEEZE xxO:®! 

xxO;/S«iuee2ei Are '/ou sure? YdlB 

RT-llSJ U05.00 

(Followed by any start-up file commands.) 



Replace Diskette 4 in Unit 1 with Diskette 2. Look at the next command 
line in SYSGEN.MON. Among the source files you need for the next assem- 
bly are USR.MAC and RMONxx.MAC (where xx is SJ or FB). These two 
source files are on Diskette 2. The other source files you need for this 
assembly are on Diskette 1. Since some of the source files are on Diskette 1 
and some are on Diskette 2, you must alter the command line appropri- 
ately. For example, if the command line were Example 1 (line 6 in Figure 
3-1), you would type the command line displayed in Example 2. 

Example 1 

MACRO/OBJsOBJiRMFB SRC: ( FB+SYSGEN . CND+EDTGBL+USR+RMONFB ) 

Example 2 

. MACRO/OBJ:xxl:RMFB xxO: ( FB + SYSGEN . CND + EDTGBL ) +x x 1 s ( USR + RMONFB ) (H) 

* 

Delete the two source files from Diskette 2 in Unit 1. 

. DELETE xxl : (USR fRMONFB) .MACdD 

Copy the object file from this assembly from Diskette 2 to Diskette 4. 

, COPY/WAIT xxl;RHFB.OBJ x xO : RMFB . OB J® 
Mount i n put y o 1 u m e in x x 1 : i C o n t i n u e ? Y <Ml 
Mount output i.ialume in xxO:i Continue? YESI 
Mount s v s t e m y o 1 u me in x x ; ! C o n t i n u e ? Y (H!) 

Then delete the object file from Diskette 2. 

. DELETE XX 1 :RMFB. OBJ®) 



Look at the next command line in SYSGEN.MON, and copy the source files 
you need for that assembly from Diskette 3 in Unit 1 to Diskette 1 in Unit 
0. For example, type: 

, COPY xxl sSYSGEN.TBL xxO : SYSGEN . TBL® 
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Replace Diskette 3 in Unit 1 with Diskette 2. Enter the command line from 
SYSGEN.MON, making the required substitutions. For example, if the 
command line were Example 1 (line 7 in Figure 3-1), you would type the 
command line displayed in Example 2. 

Example 1 

MACRO/OBJ:OBJ:TBFB SRC: ( FB + SYSGEN . CND + EDTGBL + SYSGEN . TBL) 

Example 2 

•MACRD/OBJ:xxl :TBFB xxO: ( FB + SYBGEN . CND + EDTGBL + SYSGEN . TBL) (Hi 

Then, delete the source file (that you previously copied) from Diskette 1. 

•DELETE xxOnSYSGEN.TBL® 
'SQUEEZE, xxO!@D 

Copy the object file created during this assembly from Diskette 2 to Disk- 
ette 4, and delete it from Diskette 2. 

•COPY/WAIT xxlsTBFB.DBJ x xO : TBFB . OB J® 
Mount input volume in x x 1 s 5 C o n t i n u e ? Y (lEl 
Mount output yoluwe in xxO:! Continue? Y® 
Mount s y s t e m u o 1 u w e in x x s i C o n t i n u e ? Y ® 
•DELETE xxl sTBFB.OBJiaS) 



Use the same procedure to perform ail the assemblies in SYSGEN.MON 
and SYSGEN.DEV; do not perform the link operations yet. Copy source 
files from Diskette 3 to Diskette 1, and delete them from Diskette 1 after 
the assembly is complete. After you perform each assembly, be sure to. copy 
the object file to Diskette 4 and delete it from Diskette 2. 

Ignore the ASSIGN commands. When you perform the link operations, the 
object files will already be on Diskette 4. The following list summarizes the 
sequence of operations for each subsequent assembly. 

1. Examine the next command line. If the command does not invoke 
MACRO, ignore the command line. If it invokes MACRO, establish 
which source files you need for the assembly. 

2. Copy these source files from Diskette 3 in Unit 1 to Diskette 1 in 
Unit 0. 

3. Replace Diskette 3 in Unit 1 with Diskette 2. 

4. Tj^je the command, substituting xxO: for SRC: and xxl: for OBJ: (where 
XX is DX, DY, or DZ). 

5. Delete the source files you copied in step 2 from Diskette 1, unless you 
need them for the next assembly. 
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6. Copy the object file fi-om Diskette 2 to Diskette 4. 

7. Delete the object file firom Diskette 2. 

8. Repeat steps 1 through 7 for each assembly command line. 

Now you are ready to perform the link operations. 

3.4.2 Linking Files 

Copy LINK from Diskette 3 to Diskette 1. 

. COPY xxl:LINK.SAM xxO:® 



Mount Diskette 4 in Unit 1. Find the monitor LINK command in SYS- 
GEN.MON. Type the command, substituting xxl: for OBJ:. Substitute LP: 
for MAP: if you want to send the link map to the line printer. Substitute 
TT: for MAP: if you want to send the link map to the terminal. For exam- 
ple, if the command lines were Example 1 (lines 11, 12, and 13 in Figure 
3-1), you would type the command lines displayed in Example 2. 

Example 1 

L I NK /EXE : B IN : RT 1 IFB.SYG/BOU: 1000/ PROMPT/MAP; MAP :R"^11FB OBJ:BTFB 

OBJ:RMFB.KMFB »MEFB .MIFB »TBFB// 

OMLYO 

Example 2 

. ,LINK/E;<E:x'xl:RTllFB.SYG/BDU:1000/PRDMPT/MAPiLP:RTllFB xxl:BTFB^r 
* BIN:RMFB tKMFB »MEFB.MIFB.TBFB//ill) 
Boundary section? OMLYOSl!) 

NOTE 

Save the link map that results. If you ever need to submit an 
SPR to DIGITAL for your specially generated monitor, you 
must include the monitor link map with the SPR. 

Now find the next LINK command in SYSGEN.DEV. The LINK commands 
in SYSGEN.DEV link the device handlers for which you requested support 
when you ran SYSGEN. Type all the link commands, making substitutions 
for BIN:. 

The resulting linked components on Diskette 4 have the file type .SYG. The 
.SYG files are masters for your generated monitors and handlers, and you 
should preserve them. Back up the generated system and store the backup. 

Copy the .SYG files to another diskette, along with any other components 
(for example, utility programs) you need in your working system. Refer to 
the appropriate installation chapter in the RT—11 Installation Guide, if 
necessary, to install the generated system. Rename the .SYG files, moni- 
tors and handlers, to .SYS. You can also rename the monitor to distinguish 
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it from standard monitors. You will have to copy the bootstrap for the 
generated monitor to your working system device if you want that monitor 
to boot. Note that you can always identify a user-generated monitor by the 
(S) that prints in the boot message. 

Once you have built the system, store the conditional, command, and out- 
put files from the generation process. You must retain at least the link 
maps and answer files, since a listing of these files must accompany all 
SPRs, if a custom monitor is used. 

Table 3-1: System Build Errors 



Type of Error 



Cause* 



Assembly errors 



?MACRO-F-File not. 
found DEV.FILNAM.TYP 

?MACRO-F-Device 
full DEV: 

?MACRO-F-I/0 error 
on workfile 



?MACRO-F-I/0 error 
on DEV.FILNAM.TYP 



Incorrect or conflicting responses to SYSGEN dia- 
log. 

Reexamine your responses to SYSGEN. Often, 
reading the conditional files helps you spot er- 
rors. 

If the SYSGEN responses seem correct, make 
sure that you have the proper versions of the 
source files on the source disk. Check that you 
have not introduced an error if you edited the 
source files. Compare the files on the source disk 
to the originals in the distribution. 

Failure to copy dev:filnam.typ to source disk or fail- 
ure to include all necessary source modules on the 
disk. 

Insufficient space on binary output device to accom- 
modate all output files. 

Insufficient space on default output device. Check 
the following possibilities: 

You performed the system build manually but 
did not assign the work file (or the work file 
needs more space). 

You did not squeeze the default device before 
starting the build. Try squeezing it and rebuild- 
ing. 

Bad volumes or write-protected devices. 

If the volume is bad, try another. 

If the device is write-protected, enable it. 



* If you encounter an error you cannot explain or correct, refer to the RT—11 System Mes- 
sage Manual; if you still cannot resolve the problem, send an SPR to DIGITAL with 



listings of the link maps and answer files. 
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Appendix A 

SYSGEN Answers That Will Duplicate the Standard 
Monitors 



Sections A.l and A.2 list the answers DIGITAL gave to create the standard 
(distributed) FB and XM monitors. Section A.3 lists all the SYSGEN ques- 
tions, without the descriptive text. 

A.1 SJ and FB Monitors 



1 

? 
3, 

a, 

5 , 

G, 

7, 

B, 

3, 

10. 

11 . 

12, 

13, 

14. 

15, 

IB, 

20, 

21 , 

23, 

za, 

25, 
26. 
27, 
30, 
31 , 
32, 
33, 
34, 
35, 
3B, 
B8, 



IM 

N 

N 

Y 

N 

N 

N 

N 

skipped 

skipped 

40 

134 

skipped 

N 

Y 

N 

Y 

skipped 

skipped 

skipped 

N 

N 

Y 

Y 

N 

N 

N 

N 

skipped 

N 



A-1 



Enter 


the 


device n a m e ■/ o u w ant s 


jpport for 


C d d ] : 


D 


100. 




N 








102. 




177170 








103. 




2Ga 








E n t e r 


the 


next device name C d d ] : 


DY 






100. 




N 








101 . 




N 








102. 




177170 








103. 




zsa 








Ente r 


the 


next device name [ d d ] : 


DD 






100. 




N 








102. 




17B500 








103. 




300 









Enter the next device n a w e C d d ] : P D 
Enter the next device nawe [dd]: RF 

loa. 1 

Enter the next device name Cdd]: RK 
the next device name Cdd]: D L 



Enter 
lOG. 

Enter 
107. 



the next device name Cdd]: DP 
N 



Enter the next device name Cdd]: DM 

Enter the next device name Cdd]: MT 
120. Y 
121; 2 

Enter 
120. 
121 . 

Enter 

120. 

121. 

1 O*? 
1 ^^ f 

123. 
122. 
123. 

En t e r 

Enter 

Enter 
130. 

Enter 
108. 

Enter 

En t e r 

Enter 

Enter 

Ent e r 
110. 



the next device name Cdd]; MM 
Y 

'7 

the next device name Cdd]; MS 
Y 

172522 
224 

17252G 
300 

the next device name Cdd]: CR 

the next device name Cdd]; ML 

the next device name Cdd]; LP 
N 

the next device name Cdd]: DU 
1 

the next device name Cdd]; LD 

the next device name Cdd]; "^M 

the next device name Cdd]; D2 

the next device name Cdd]; DW 

the next device name Cdd]; SP 
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Enter the next device name Cdd]: XL 

151. 17B500 

152. 300 

Enter the next deuice name Cdd]; XC 

Enter the next device name Cdd]: LS 

133. Y 

134. 173400 

135. 220 

Enter the next device name Cdd]: DT 

Enter the next device name Cdd]: OS 
105. Y 

Enter the next device name Cdd]: CT 

Enter the next device name Cdd]: .SI 
IBO. 



170. N 

A.2 KM Monitor 



1 , 


N 


2. 


N 


3. 


Y 


4. 


skipped 


5. 


Y 


B. 


skipped 


7. 


Y 


8. 


Y 


9. 


N 


10. 


N 


11. 


skipped 


12. 


skipped 


13. 


40 


14. 


134 


15. 


Y 


IB. 


N 


20. 


Y 


21. 


N 


22. 


Y 


23. 


skipped 


24. 


skipped 


25. 


skipped 


2B. 


N 


27. 


N 


30. 


Y 


31. 


Y 


32. 


N 


33. 


• N 


34. 


N 


35. 


N 


B8. 


N 



Enter the device name you want support for Cdd]: D>! 

100. IM 

102, 177170 

103. 2B4 

Enter the next device name C d d 1 : DY 
1 . N 

101. N 

102. 177170 

103. 2B4 
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the 



Enter 
1 . 
102 . 
103. 



Enter the 

Enter the 
lOG. 

Enter the 

Enter the 
120. 
121 . 



next d e M i c e 

N 

17B500 

3 

next d e 1.) i c B 

next d e M i c e 

next device 

next device 



name C d d D : DD 



n a m e 
n a m e 



n a III e 
n a (I) e 



[ d d ] 
[ d d ] 

[ d d ] 
C d d 3 



Enter 
120. 
121 . 

Enter 

120. 

121. 

1. £^£^ t 

123. 

i. £.«!. * 

123. 



the next device name C d d ] 



the next device name [ d d ] 



1 '7'7'S'? '^ 

224 

17252B 
3 



Enter the next device 
the 



Enter 
130. 

Enter 
108. 

Enter 

Enter 

Enter 

Ente r 

Enter 
110. 

Ente r 
151 . 
152, 



the 

the 
the 
the 
the 
the 

the 



Enter the 

Enter the 
133. 
134. 
135. 



Enter 
IBO. 



the 



next device 
N 

next device 
1 

next device 

next device 

next device 

next device 

next device 
Y 

next device 
17G500 
3 

next device 

next device 
Y 

173400 
220 

next device 
4 



n a m e 
n a m e 



Cdd] 
[ d d ] 



name C d d ] 



name 
name 
n a m e 
n a m e 
n a m e 



[dd] 
Cdd] 
[dd] 
Cdd] 
Cdd] 



n a m e Cdd] 



n a m e 
n a m e 



Cdd] 
Cdd] 



RK 
DL 

DM 
MT 

MM 

MB 



NL 
LP 

DU 

LD 
MM 
D2 
DW 
SP 

XL 

KG 
LB 



name Cdd] 
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A.3 SYSGEN Questions 



Do '/ 1.1 want an introduction to system feneration ( N ) ? 

Do voLi want to use a p re u i o us 1 -/ created answer file (N)? 

What answer file do you want to use ( SYSGEN . ANS ) ? 

Do you want to create an answer file ( N ) ? 

What answer file do you want to create ( SYSGEN . ANS ) ? 

Do '/ou want to create a new SYSGEN. ANS file (N)? 

MONITOR TYPE 
1 . Do you want the s i n S 1 e - J o b ( S J ) monitor ( Y ) ? 

2. Do you want the f o r e 3 ro un d / b ac K S ro un d (FB) monitor (Y)? 

3. Do you want the extended memory (XM) monitor (N)? 

MONITOR OPTIONS 
4 . Do you want timer support in the S J monitor ( N ) ? 
5 . Do you want device timeout support ( N ) ? 

6 . Do you want an error m e s s a 3 e on system I/O errors ( Y ) ? 

7 . Do you want system Job support ( N ) ? 

8. Do you want to use the .SPCPS request (N)? 

9. Do you want sllobal SCCA support (N)? 

10. Do you want mu 1 1 i t e rmi n a 1 support (N)? 

11. Do you want asynchronous terminal s t a t u s ( Y ) ? 

12. Do you w ant m u 1 1 i t e r m i n a 1 timeout support ( Y ) ? 

13. Enter the size of the output buffers (40): 
la, Enter the size of the input buffers (134): 

15. Do you want to use the .FETCH request under X M ( Y ) ? 
IB. Do you want end of month and year date r o 1 1 o y e r ( N ) ? 

20. Do you want the user c o m m a n d 1 i n K a ^ e ( N ) ? 

21. Do you want h i S h - s p e e d r i n 3 buffer support ( N ) ? 

22. Do you want all the Keyboard monitor commands ( Y ) ? 

23. Do you want the UTILITY subset (Y)? 

24. Do you want the LANGUAGE subset (Y)? 

25. Do you want the MINIMAL subset (Y)? 

2 B . Do you want the optional 50 Hz clock support ( N ) ? 

27. Do you want to use the KWll-P clocK as the system clocK (N)' 

30. Do you want the s t a r t - u p indirect file ( Y ) ? 



SYSGEN Answers That Will Duplicate the Standard Monitors A-5 



31. Do you want floating point support ( Y ) ? 

32. Do you w ant memory parity support ( N ) ? 

33. Do you want power failure m e s s a 3 e s ( N ) ? 

34. Do you want BATCH support (N)? 

35. Do you want error 1 o 3 3 i n 3 ( N ) ? 

3 B . How many device units does error 1 o 3 Job support (10)? 

B 8 . Do you want to define any other system conditionals ( N ) ? 

B 9 . Enter the system conditional and value: 

DEVICE OPTIONS 
Enter the device name you want support for [ d d ] : 
Do you want a list of available devices ( Y ) ? 

100. Do you want support for a second < d e v i c e > controller ( N ) ? 

101. Do you want R )•( 2 d o u b 1 e - d e n s i t y only support ( N ) ? 

102. What is the CSR address for the <nth> <device> (nnnnnn)? 

103. What is the vector address for the <nth> <device> (nnn)? 

104. How many disK platters are installed on the RFll (1)? 

105. Do you want RJS03 rather than RJS04 support (Y)? 
lOB. How many RL01/RL02 units are to be supported (2)? 

107. Do you want RPR02 rather than RPR02/RP03 support (N)? 

108. How many ports are to be supported (1)? 
110. Do you want support for banner pa3es (Y)? 

120. Do you want the f i 1 e- s t rue t u re d mastape handler (Y)? 

121. How many mastape units are to be supported (2)? 

122. What is the address of the <nth> unit (nnnnnn)? 

123. What is the vector address of the <nth> unit (nnn)? 

130. Do,es your printer have a nonstandard vector or CSR (N)? 

131. What is the CSR address for the printer (177514)? 

132. What is the vector address for the printer (200)? 

133. Do you want support for the PC300 printer port (N)? 

134. What is the CSR for the serial line printer (17B500)? 

135. What is the vector for the serial line printer (300)? 

151, What is the CSR address for XL (17B500)? 

152. What is the vector address for XL (300)? 

Do you want to add support for any of your own devices ( N ) ? 
Enter the device name you want support for Cdd]s 

1 B . How many extra device slots do you want ( ) ? 
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GRAPHICS OPTIONS 

170. Do you want UTll or USBO Graphics support ( Nl ) ? 

171. Do you want USBO support (N)? 

172. What is the CSR address for the VTll/ySGO (172000)? 

173. What is the vector address for the UTll/OSBO (320)? 

TERMINAL INTERFACE OPTIONS 
Do you want an introduction to terminal interface options (N)? 

180. How many local DLll linest including the console* are to be 
supported (1)? 

181. How many remote DLll lines are to be supported (0)? 

182. What is the CSR address for the <nth> DLll (1775B0)? 

183. What is the vector for the <nth> DLll (BO)? 

184. Do you want DZll or DZUll multiplexer support (N)? 

185. Do you want DZll multiplexer support (Y)? 

18B. How many DZ multiplexers are to be supported (1)? 

187. How many local DZ lines are to be supported altogether (1)? 

188. How many remote DZ lines are to be supported altogether (0)? 

189. What is the CSR for the <nth> DZ multiplexer (160010)? 

190. What is the vector for the <nth> DZ multiplexer (300)? 

191. What baud rate do you want your lines initialized to (300)? 
Do you want to change any of your responses (N)? 

Do you want to chanSe monitor/terminal option responses (N)? 

What question number do you want r e - a s k e d ? 

Do you want to change your device support (N)? 

Do you want to remove support for any device (N)? 

What device do you NOT want supported? 

Do you want a list of available devices (Y)? 

Do you want to add support for any device or have the questions for 
any device re-asked (N)? 

Do you want to a d d / m o d i f y a DIGITAL supported device ( Y ) ? 

Enter the device name to a d d / m o d i f y [ d d ] : 

Do you want to define or redefine any system conditionals ( N ) ? 

DEUICE SELECTION AND SYSGEN CLEANUP 

What is the name of the source input device C x x n ] ( d d n ) ? 

What is the name of the binary output device Cxxn] (ddn)? 

What is the name of the map output device [ x x n ] (ddn)? 

Do you want to retain the system B J s ( Y ) ? 

Do you want to retain the work files ( Y ) ? 
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Appendix B 

SYSGEN Answers That Create a Multltermma! 
System 



This appendix lists SYSGEN answers that create an example of a multiter- 
minal system. Refer to Appendix A for a list of the SYSGEN questions. 

Note that this is intended to be only an example. It is highly improbable 
that the example would exactly meet your needs or that the CSR and vector 
addresses given in the example would be the same for your hardware con- 
figuration. DIGITAL does not recommend using this example, as is. 

This example creates a foreground/background multiterminal system. De- 
vice support includes RK05 disk, RXOl diskette, and eight terminals with a 
DZll-A 8-line multiplexer. 



1 . 


N 


2. 


Y 


3, 


N 


a. 


skipped 


5. 


Y 


B. 


skipped 


7, 


N 


B. 


N 


g. 


N 


10, 


Y 


11 . 


Y 


12. 


Y 


13. 


ao 


la. 


134 


15. 


skipped 


IB. 


N 


20. 


Y 


21. 


N 


22. 


Y 


23. 


skipped 


24. 


skipped 


25. 


skipped 


26. 


N 


27. 


N 


30. 


Y 



B-1 



31 . 


Y 


32. 


N 


33. 


N 


3a, 


N 


35. 


N 


BB. - 


N 



Enter the d e m i c e n a m e v o u want support for C d d ] : D X 
1 . N 

102. 177170 

103. 26^^ 

Enter the next device name C d d ] : R K 

Enter the next device name Cddl: LP 
130. N 

Enter the next dev i ce name Cd'd]:Dy- 
108. 1 

Enter the next device name [ d d ] : D L 
lOB. 2 

133. N 

134. 17B500 

135. 300 

Enter the next device name Cdd]: '.'M 

Enter the next device name Cdd]; SP 
11,0.' Y , 

Enter the next device name Cdd]: NL 



Enter 


the next device name Cdd]: <® 


1B0« 


. . 4 




180. 


8 




181. 







182. 


1775B0 




183. 


GO 




182. 


17B500 




183, 


300 




182. 


17G510 




183. 


310 




182. 


17B520 




183. 


320 




182. 


17B530 




183. 


330 




182. 


17B540 




183. 


340 




182. 


17B550 




183. 


350 




182. 


17B5B0 




183. 


3B0 




184, 


Y 




185, 


Y 




18B. 


1 




187. 


8 




188. 







183. 


1 BOO 10 




130. 


300 




191. 


300 
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Appendix C 
RT-11 Conditionals 



The following listings contain the conditionals that the RT-11 system uses, 
with a brief explanation of each conditional. The symbols in these listings 
have the following meanings: 

Symbol Meaning 

n n n n n n CSR address 

n n n Vector address 

n Number 

X Number of local DL interfaces 

y Number of remote DLll-E lines 



C.1 System Conditionals 



AI$COD 


= 


1 


SAUTOMATIC INSTALLATION MONITOR 


BATC$H 


= 


1 


5BATCH SUPPORT 


CLOCK 


= 


50. 


JPOWER LINE FREQUENCY (50 CYCLE) 


CLOCK 


= 


BO. 


iPOWER LINE FREQUENCY (BO CYCLE) 


CONT$N 


= 


1 


JCONTINUATION INDIRECT FILE 


CT$CSR 


r 


nnnnnn 


•STATUS REGISTER FOR TAll CASSETTE 


CT$UEC 


= 


nnn 


IVECTOR FOR TAll CASSETTE 


DD$PRI 


= 


n 


iDECTAPE II PRIORITY 


DO*CSR 


= 


nnnnnn 


iSTATUS REGISTER FOR FIRST DECTAPE II CONTROLLER 


DD$yEC 


= 


nnn 


JVECTOR FOR FIRST DECTAPE II CONTROLLER 


DD$CS2 


= 


nnnnnn 


;SECOND DECTAPE II CONTROLLER STATUS REGISTER 


DD$VC2 


= 


nnn 


.VECTOR FOR SECOND DECTAPE II CONTROLLER 


DDT$0 


:= 


1 


iSECOND DECTAPE II CONTROLLER IS PRESENT 


DL*UN 


= 


n 


iNUMBER OF RL01/RL02 UNITS 


DL11*L 


= 


X 


;number of local dlii interfaces 


DL11$M 


= 


y 


.NUMBER OF REMOTE DLll-E LINES 


DL11$N 


= 


X + y 


;T0TAL NUMBER OF DLll LINES 


DLC$0 


= 


nnnnnn 


;CSR OF FIRST DLll (CONSOLE) 


DLy*0 


= 


nnn 


5UECT0R OF FIRST DLll (CONSOLE) 


DLC$1 


= 


nnnnnn 


iCSR OF SECOND DLll (LOCAL OR REMOTE) 


DLV*! 


= 


nnn 


;yECTOR OF SECOND DLll (LOCAL OR REMOTE) 


DLC$2 


= 


nnnnnn 


;CSR OF THIRD DLll (LOCAL OR REMOTE) 


DLM*2 


= 


nnn 


JMECTOR OF THIRD DLll (LOCAL OR REMOTE) 



C-1 



DLC$3 
DLU$3 
DLC*4 

DLC*5 

DLM$5 

DLC$B 

DLV$B 

DLC$7 

DLV$7 

DU$CS2 

DU$MC2 

DU$CS3 

DU$MC3 

DU$CS4 

DU$UC4 

DU$POR 

DX$CSR 

DXSVEC 

DX*CS2 

DX$MC2 

DKT$0 

DY$DD 

DY$CSR 

DY$MEC 

DY*CS2 

DY$VC2 

DYT*0 

DZ11*N 

DZ11$N 

DZV$11 

DZVSll 

DZCB$0 

Dzyc*o 

DZCS*1 
DZVC$1 
DZCS$2 
DZVC$2 
DZCS$3 
DZVC$3 
DZ11$L 
DZIUM 
DZSP*D 
DZST$P 

EIS*I 
EMPTY 
EMPTY 
ERL$G 
ERL$S 
ERL$U 

FPU$11 

GRhFX 

HELP*B 
HSR$B 

JOB$ 

KW11*P 

L$ANG 

LET$ 

LETNO$ 



n n n n n n 

nnn 

n n n n n n 

nnn 

n n n n n n 

nnn 

nnnnnn 

nnn 

nnnnnn 

nnn 

nnnnnn 

nnn 

nnnnnn 

nnn 

nnnnnn 

nnn 

n 

nnnnnn 

nnn 

nnnnnn 

nnn 

1 

1 

nnnnnn 

nnn 

nnnnnn 

nnn 

1 



n 



1 

nnnnnn 

nnn 

nnnnnn 

nnn 

nnnnnn 

nnn 

nnnnnn 

nnn 

n 

n 

n 

n 

1 


n 
1 
1 
n 



= 1 

= i 

= 1 

= 1 

= n 

= 1 

= 1 

= 1 

= n 



CSR OF 

VECTOR 

CSR OF 

VECTOR 

CSR OF 

VECTOR 

CSR OF 

VECTOR 

CSR OF 

VECTOR 

STATUS 

VECTOR 

STATUS 

VECTOR 

STATUS 

VECTOR 

NUMBER 

STATUS 

VECTOR 

STATUS 

VECTOR 

SECOND 

RX02 DO 

STATUS 

VECTOR 

STATUS 

VECTOR 

SECOND 

NO DZll 

NUMBER 

DZll MU 

DZVll M 

CSR FOR 

VECTOR 

CSR FOR 

VECTOR 

CSR FDR 

VECTOR 

CSR FOR 

VECTOR 

NUMBER 

NUMBER 

BAUD RA 

STOP UN 



FOURTH DLl 
OF FOURTH 
FIFTH- DLll 
OF FIFTH D 
SIXTH DLll 
OF SIXTH D 
SEVENTH DL 
OF SEVENTH 
EIGHTH DLl 
OF EIGHTH 
REGISTER F 
FOR SECOND 
REGISTER F 
FOR THIRD 
REGISTER F 
FOR FOURTH 
OF MSCP PO 
REGISTER F 
FOR FIRST 
REGISTER F 
FOR SECOND 
RXll CONTR 
UBLE DENSI 
REGISTER F 
FOR FIRST 
REGISTER F 
FOR SECOND 
RX02 CONTR 

OR DZVll 
OF DZll OR 
LTIPLEXER 
ULTIPLEXER 

FIRST DZl 
FOR FIRST 

SECOND DZ 
FOR SECOND 

THIRD DZV 
FOR THIRD 

FOURTH DZ 
FOR FOURTH 
OF LOCAL L 
OF REMOTE 
TE 
IT 



1 (LOC 
DLll ( 

(LOCA 
Lll (L 

(LOCA 
Lll (L 
11 (LOC 

DLll 
1 (LOC 
DLll ( 
OR SEC 

MSCP 
OR THI 
MSCP 
OR FOU 

MSCP 
RTS 

OR FIR 
RXll 
OR SEC 

RXll 
OLLER 
TY ONL 
OR FIR 
RX02 
OR SEC 

RX02 
OLLER 
SUPPOR 

DZVll 
SUPPOR 

SUPPO 
1 

DZll 
11 

DZll 
11 

DZVll 
VI 1 

DZVll 
INES 
LINES 



AL OR REMOTE) 
LOCAL OR REMOTE) 
L OR REMOTE) 
OCAL OR REMOTE) 
L OR REMOTE) 
OCAL OR REMOTE) 
AL OR REMOTE) 
(LOCAL OR REMOTE) 
AL OR REMOTE) 
LOCAL OR REMOTE) 
OND MSCP 

RD MSCP 

RTH MSCP 

ST RXll 

OND RXll 

IS PRESENT 

Y 

ST RX02 

OND RX02 

IS PRESENT 
T 

MULTIPLEXERS SUPPORTED 
T 
RT 



USE EIS INSTRUCTIONS 

NO EMPTY DEVICE SLOTS 

NUMBER OF EMPTY DEVICE SLOTS 

ERROR LOG SUPPORT 

ERROR LOG BUFFER SIZE IN BLOCKS 

NUMBER OF UNITS TO BE LOGGED 

FLOATING POINT SUPPORT 

GRAPHICS SUPPORT 

USE LARGE SINGLE LINE EDITOR HELP DISPLAY 
HIGH SPEED RING BUFFER 

NUMBER OF JOBS SUPPORTED BY SINGLE LINE EDITOR 

USE KH11$P CLOCK AS SYSTEM CLOCK 

LANGUAGE COMMANDS 

SUPPORT LET AS CCL (SINGLE LINE EDITOR) 

LET ASSIGNMENT COUNT (SINGLE LINE EDITOR) 



C-2 RT-11 Conditionals 



LETBZ$ 


= 


n 


LINSZ$ 


= 


n 


LIGH$T 


= 


1 


LP.CSZ 


= 


n 


LP.PSZ 


= 


n 


LS.CSZ 


= 


n 


LS.PSZ 


= 


n 


LP$CSR 


= 


n n n n n n 


LP$yEC 


= 


n n I'l 


LS$C5R 


= 


n n n n n n 


LS$yEC 


= 


n n n 


LS$PC 


= 


1 


M$INI 


= 


1 


MAT$S 


= 


1 


MM$FSri 


= 


1 


MM$UN 


= 


n 


MPT$Y 


= 


1 


MqH$P2 


= 


1 


MS$FSM 


= 


1 


MS$UN 


= 


n 


MS$CSR 


= 


n n n n n n 


MS$yEC 


= 


n n n 


MS*CS1 


= 


n n n n n n 


MS$UC1 


= 


n 11 n 


MS$CS2 


= 


n n n n n n 


MS$i.'C2 


= 


nnn 


MS$CS3 


= 


n n n nnn 


MS$MC3 


= 


n n n 


MS$CS4 


= 


n n n n n n 


MS$MC4 


= 


n n n 


MS$CS5 


= 


n n n n n n 


MS$yC5 


= 


nnn 


MS$CSB 


= 


n n n n n n 


MS$UCS 


= 


nnn 


MS$CS7 


= 


n n n n n n 


MS$i,'C7 


= 


n n n 


MT$FSM 


= 


1 


MT$UIM 


= 


n 


MTI$M 


= 


1 


MTT$Y 


= 


1 


OFORM 


= 


1 


PDT$DP 


= 


1 


PP$CSR 


= 


n n n n n n 


PP$VEC 


= 


n n n 


PR11$X 


= 





PWF$L 


= 


1 


$RFNUM 


= 


n 


RDF$L 


= 





RDF$L 


= 


1 


RJS0$3 


= 





RJS0$3 


= 


1 


RKB$B 


= 


1 


RKB$S 


= 


1 


RQL$OV 


= 


1 


RP0$3 


= 





RP0$3 


= 


1 


RTE$M 


= 


1 


SCCA$G 


= 


1 


SILN$T 


= 


1 


SJONLY 


= 


1 



LET STRING LENGTH (SINGLE LINE EDITOR) 
DEFAULT LINE SIZE (SINGLE LINE EDITOR) 
LIGHTS ROUTINE FOR 11/45 AND 11/70 
DEFAULT MALUE FOR "SET LP WIDTH=nn" 
DEFAULT UALUE FOR "SET LP LENGTH=nn" 
DEFAULT UALUE FOR "SET LS WIDTH=nn" 
DEFAULT UALUE FOR "SET LS LENGTH=nn" 
NON-STANDARD LINE PRINTER CSR 
NON-STANDARD LINE PRINTER UECTOR 
CSR FOR SERIAL LP 
UECTOR FOR SERIAL LP 

LS SUPPORT FOR BOTH PRO 300 PRINTER PORT 
AND DL INTERFACES 

MINIMAL COMMANDS 

ASYNCHRONOUS TERMINAL STATUS 

TJUIG FILE-STRUCTURE SUPPORT 

NUMBER OF TJUIB UNITS 

MEMORY PARITY SUPPORT 

USE 2 PARS FOR MQ: AND INTERRUPT FORWARDING 

TSll FILE-STRUCTURED SUPPORT 

NUMBER OF TSll UNITS 

STATUS REGISTER OF FIRST TSll 

UECTOR OF FIRST TSll 

STATUS REGISTER OF SECOND TSll 

UECTOR OF SECOND TSll 

STATUS REGISTER OF THIRD TSll 

UECTOR OF THIRD TSll 

STATUS REGISTER OF FOURTH TSll 

UECTOR OF FOURTH TSll UNIT 

STATUS REGISTER OF FIFTH TSll 

UECTOR OF FIFTH TSll 

STATUS REGISTER OF SIXTH TSll 

UECTOR OF SIXTH TSll 

STATUS REGISTER OF SEUENTH TSll 

UECTOR OF SEUENTH TSll 

STATUS REGISTER OF EIGHTH TSll 

UECTOR OF EIGHTH TSll 

TMll FILE-STRUCTURE SUPPORT 

NUMBER OF TMll UNITS 

TERMINAL TIME OUT 

MULTITERMINAL SUPPORT 

FORM PROCESSING ( LEN » FF . SKIP) LP: LS; 

PDT SUPPORT 

pen PP STATUS REGISTER 

pen PP UECTOR 

pen OR PRll READER/PUNCH 

POWER FAIL 

NUMBER OF RFll PLATTERS 

NO SYSTEM I/O ERROR MESSAGE 

ADD SYSTEM I/O ERROR MESSAGE 

RJS DISK IS RJS04 

RJS DISK IS RJS03 

BAD BLOCK SUPPORT FOR RKOB/07 DISK 

SPECIAL FUNCTIONS FOR RKOB/07 DISK 

MONTH ROLLOUER SUPPORT 

RPll DISK IS RP02/RPR02 

RPll DISK IS RP03 

MONITOR RUNNING UNDER RTEM-11 

GLOBAL SCCA SUPPORT 

BOOT MESSAGE NOT DISPLAYED 

LOGICAL DISK SUPPORT FOR SJ ONLY 



RT-11 Conditionals C-3 



SK$CSR 
SK$yEC 
SPC$PS 
SP$FLG 
STAR$T 
SYSG$N 
SYT$K 

TIM$IT 
TIME*R 
TTYIN 
TTYOUT 

U.K. 
U$CL 
U$TIL 

UM$BAS 

USBO$ 

t,'Tll$ 

UT52$ 

MT1C)0$ 

MT102$ 

MT.CSR 

MT.MEC 

XL$PC 

XL$CBR 

XL$yEC 

XM*FET 

XTNCHN 

XT$PRI 

XT$CSO 

XT$VCO 

XT$CS1 

XT$MC1 

XT$CS2 

XTSVCZ 

XT*CS3 

XT$MC3 

XT$CS4 

XT$UC4 

XT$CS5 

XT$yC5 

XT$CSB 

XT$MCG 

XT$CS7 

XT$UC7 



n n n n n n 

n n n 

1 

1 

1 

1 

1 

1 
1 
n 
n 

1 
1 
1 

n 

1 

1 

1 

1 

1 

n n n n n n 

n n n 



= 1 



n n n n n n 

nnri 

1 

n 

n 

nnnnnn 

nnn 

n n n n n vi 

n n n 

n n n n n n 

n n n 

n n n n n n 

nnn 

nnnnnn 

nnn 

nnnnnn 

n n n 

nnnnnn 

nnn 

n n n n n n 

nnn 



SK STATUS REGISTER 

SK VECTOR 

SAME/SET MAIN-LINE PC AND PS SUPPORT 

SPOOL HANDLER FLAG PAGE SUPPORT 

STARTUP COMMAND FILE 

INDICATE SYSGENED MONITOR 

SYSTEM JOB SUPPORT 

ADD DEMICE TIMER SUPPORT 
ADD SJ TIMER SUPPORT 
SIZE OF INPUT RING BUFFERS 
SIZE OF OUTPUT RING BUFFERS 

UK MODEM SUPPORT 

USER COMMAND LINKAGE SUPPORT 

UTILITY COMMANDS 

MMX: LOWEST ADDRESS TO USE (/B^.) 
MSGO DISPLAY SUPPORT 
MTll DISPLAY SUPPORT 

MT52 SUPPORT WITH SINGLE LINE EDITOR 
UTIOO SUPPORT WITH SINGLE LINE EDITOR 
UT102 SUPPORT WITH SINGLE LINE EDITOR 
CSR FOR UTll/USBO 
MECTOR FOR yTll/MSGO 



SUPPORT FOR PRO 300 COMMUNI 
CSR OF DL(M)-11 FOR XL 
MECTOR OF DL(M)-11 FOR XL 
.FETCH SUPPORT IN XM 
NUMBER OF DL-TYPE SERIAL LI 
PRIORITY OF DL-TYPE SERIAL 
STATUS REGISTER OF FIRST DL 
MECTOR OF FIRST DL-TYPE LIN 
STATUS REGISTER OF SECOND D 
MECTOR OF SECOND DL-TYPE LI 
STATUS REGISTER OF THIRD DL 
MECTOR OF THIRD DL-TYPE LIN 
STATUS REGISTER OF FOURTH D 
MECTOR OF FOURTH DL-TYPE LI 
STATUS REGISTER OF FIFTH DL 
MECTOR OF FIFTH DL-TYPE LIN 
STATUS REGISTER OF SIXTH DL 
MECTOR OF SIXTH DL-TYPE LIN 
STATUS REGISTER OF SEMENTH 
MECTOR OF SEMENTH DL-TYPE L 
STATUS REGISTER OF EIGHTH D 
MECTOR OF EIGHTH DL-TYPE LI 



CATIONS PORT 



NES 

LINES 

-TYPE LINE 

E 

L-TYPE LINE 

NE 

-TYPE LINE 

E 

L-TYPE LINE 

NE 

-TYPE LINE 

E 

TYPE LINE 
E 

DL-TYPE LINE 
INE 

L-TYPE LINE 
NE 



C.1.1 SJ.MAC 



BF 



= 



;SJ MONITOR SUPPORT 



C.1.2 FB.MAC 



BF 



;N0 SJ MONITOR SUPPORT 



C.1.3 XM.MAC 



BF = 1 

MMG$T = 1 



iNO SJ MONITOR SUPPORT 
iMEMORY MANAGEMENT SUPPORT 



C-4 RT-11 Conditionals 



C.2 Individual Keyboard Monitor Command Conditionals 

To include or exclude individual keyboard commands, insert the particular 
conditional in SYSGEN.CND and substitute (to exclude the command) or 
1 (to include the command) for n. 

Utility Program Subset 



U$TIL 



;iF N IS SET EQUAL TO 0, ALL 
5UTILITY COMMANDS DEFAULT = 
;iF N IS SET EQUAL TO 1 . ALL 
JUTILITY COMMANDS DEFAULT = 1 



BACK$$ 


= 


n 


BACKUP 


BOOT$$ 


= 


n 


BOOT 


COPY$$ 


= 


n 


COPY 


CREA$* 


= 


n 


CREATE 


DELE$$ 


= 


n 


DELETE 


DIFF$$ 


= 


n 


DIFFERENCES 


DIRE$$ 


= 


n 


DIRECTORY 


DUMP$* 


= 


n 


DUMP 


EDIT** 


= 


n 


EDIT 


FORM** 


= 


n 


FORMAT 


INIT** 


= 


n 


INITIALIZE 


PRIN** 


= 


n 


PRINT 


PROT** 


= 


n 


PROTECT 


RENA** 


= 


n 


RENAME 


SHOW** 


= 


n 


SHOW 


SQUE** 


= 


n 


SQUEEZE 


TYPE** 


= 


n 


TYPE 


UNPR** 


= 


n 


UNPROTECT 



Language Subset 



L*ANG 



;iF N IS SET EQUAL TO 0» ALL 
JLANGUAGE COMMANDS DEFAULT = 
ilF N IS SET EQUAL TO 1 . ALL 
iLANGUAGE COMMANDS DEFAULT = 1 



CDMP** 


= n 


iCOMPILE 


DIBO** 


= n 


iDIBOL 


EXEC** 


= n 


.EXECUTE 


FORT** 


= n 


iFORTRAN 


LIBR** 


= n 


iLIBRARY 


LINK** 


= n 


SLINK 


MACR** 


= n 


iMACRO 



Minimal Subset 



M*INI 



;iF N IS SET EQUAL TO 0» ALL 
JMINIMAL COMMANDS DEFAULT = 
5IF N IS SET EQUAL TO 1 , ALL 
iMINIMAL COMMANDS DEFAULT = 1 



ABOR** 


= n 


jABORT 


ASSI** 


= n 


iASSIGN 


B** 


= n 


iBASE 


CLOS** 


= n 


iCLDSE 


D** 


= n 


iDEPOSIT 



RT-11 Conditionals C-5 



DATE$$ 


= 


n 


DATE 


DEAS$$ 


= 


ri 


DEASSIGN 


DISM$$ 


= 


n 


DISMOUNT 


E$$ 


= 


n 


EXAMINE 


FRUN$$ 


= 


n 


FRUN 


GET** 


= 


n 


GET 


GT** 


= 


n 


GT ON/OFF 


HELP** 


= 


n 


HELP 


INST*$ 


= 


n 


INSTALL 


LOAD** 


= 


n 


LOAD 


MOUN** 


= 


n 


MOUNT 


REEN** 


= 


n 


REENTER 


REMO** 


= 


n 


REMOUE 


RESE** 


= 


n 


RESET 


RESU** 


= 


n 


RESUME 


SAVE** 


= 


n 


SAUE 


SET** , 


= 


n 


SET 


SRUN** 


= 


n 


SRUN 


STAR** 


= 


n 


START 


SUSP** 


= 


n 


SUSPEND 


TIME** 


= 


n 


TIME 


UNLO** 


= 


n 


UNLOAD 



C.3 Naming-Convention Conditionals 

The following conditionals control monitor, handler, and start-up command 
file naming conventions. 



NAME*1 


= 'R 


NAME*2 


= 'T 


NAME*3 


= 'I 


NAME*/i 


= '1 


NAME*5 


= 'III 


NAME*B 


= 'ri 



iFIRST CHARACTER OF MONITOR NAME 
i'sECOND CHARACTER OF MONITOR NAME 
JTHIRD CHARACTER OF MONITOR NAME 
iFOURTH CHARACTER OF MONITOR NAME 
;FIFTH CHARACTER OF MONITOR NAME 
iSIXTH CHARACTER OF MONITOR NAME 



All characters must be both valid ASCII and Radix-50 characters. Default 
values are assigned for standard monitor names according to the settings of 
the following conditionals: 



Conditionals 

BF = 

BF = 1RTE$M = 

BF = 1 

BF = 1RTE$M = 1 



MMG$T = 
MMG$T = 1 
MMG$T = 



Monitor Names 



RTllSJ 



RTllFB 

RTllXM 

RTEMFB 



SUFK*H 



iSUFFIX CHARACTER FOR HANDLER FILE 
;NAME to INDICATE MONITOR TYPE 



All characters must be both valid ASCII and Radix-50 characters. Default 
values are assigned for standard handler names according to the settings of 
the following conditionals: 
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Conditionals 

BF = 

BF = 1RTE$M = 
BF = 1 
BF=1RTE$M = 1 



MMG$T = 
MMG$T = 1 
MMG$T = 



Standard Suffix 

space 
space 
X 
M 



SUFX$X 



iSUFFIX CHARACTER FDR STARTUP FILE 
iNAME TO INDICATE MONITOR TYPE 



All characters must be both valid ASCII and Radix-50 characters. Default 
values are assigned for standard monitor names according to the settings of 
the following conditionals: 



Conditionals 



Standard Suffix 



BF = 1RTE$M=1 MMG$T = M 

Otherwise, the NAME$5 value is used. 
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Appendix D 

Customizations for Specially Generated Monitors 



In the following software customizations, lowercase alphabetic x represents 
a character that varies according to the specific software component you are 
modifying. 

D.1 instaiiing Only the Generated Handlers 

Normally, when you bootstrap an RT-11 system, the monitor automatically 
installs any device handlers that are present on the system device, if there 
are enough device slots for them. Under certain circumstances, you may 
want the system to include only the handlers that you named during your 
system generation process. To prevent the system from recognizing han- 
dlers that you did not specify during system generation, install the follow- 
ing customization. 

NOTE 

Do not install this customization on any of the distributed 
monitors. 

In this customization, monitr.SYS is the name of the monitor file that you 
want to modify, and ..INS A is the value of that symbol from the monitor 
link map. 



.RUN SIRPd 


m 






*n)onit r.SYS® 






Base? 


OMs 






Dff set? 


< , INSA® 






Base 


Offset 


Old 


New 


000000 


. .INSA 


010105 


240® 


000000 


. , INSA+2 


020200 


tCTRL/Y )(REn 


*(CTRL/Cl 





If the monitor you want to alter is the hardware bootable monitor, write a 
new system bootstrap with the COPY/BOOT command. 



D-1 



D.2 Suppressing the Muititerminal Polling Routines 

If you selected DZ-11 modem support or the muititerminal timeout feature 
when you performed your system generation, the monitor automatically 
polls the terminal lines twice every second. This can cause ODT to malfunc- 
tion. If you make the following modification to the monitor, it will not do 
this periodic polling. This allows you to use ODT, but defeats the value of 
the muititerminal timeout feature, and prevents the monitor from recogniz- 
ing remote DZ-11 or DZV-11 lines. 

In the customization, monitr.SYS is the name of the monitor file that you 
want to modify, and ..DZOD is the value of that symbol from the monitor 
link map. 



.RUN SIPPi 


m 




*(,ioriitr,SYS(aSl 




Base? 


0® 




Of.f set? 


. .DZOD® 




Base 


Offset 


Old 


000000 


..DZOD 


000000 


000000 


. .DZOD+2 


001002 



New 
IB) 

(CTRL' Y ) 



* (CTRL/Cl 



If the monitor you want to alter is the hardware bootable monitor, write a 
new system bootstrap with the COPY/BOOT command. 

D.3 Changing the Handler File-Name Suffix 

In an ordinary RT-11 SJ or FB system, the monitor recognizes device han- 
dlers by the format of their names. Device handler names have the format 
dd.SYS. In an XM system, handlers are in files named ddX.SYS. Thus, two 
sets of handlers can coexist on one system volume. 

If you generate one or more monitors with different combinations of the 
device timeout, error logging, and extended memory features, you can have 
need of up to eight different sets of device handlers. You can keep such 
handlers on one system volume by associating one or more monitors with 
the corresponding handlers. Do this by customizing the monitor so that it 
recognizes device handler file names of the form ddn.SYS, where n is any 
alphabetic character that you choose. Then rename the corresponding han- 
dler files. 

In this customization, monitr.SYS is the name of the monitor file that you 
y/ant to modify, and z is the one-character suffix that you use v/heh you 
rename the associated handlers. The old values depend on the system gen- 
eration options that you chose. 

. RUN SIPP® 
* (nan it r.SYS® 
Base? 0® 

Offset? aiiaM) 
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Ba.se Offset Old New 

000000 00477^ 000030 iRil) 

000000 001X11 li < )<> jRdEIIBsdB 

4 7 7 B < n n n > (ctrl/y ) (ret) 

* [CTRL/Cl 

If the monitor you want to alter is the hardware bootable monitor, write a 
new system bootstrap with the COPY/BOOT command. 

D.4 Changing the Default Device for the SRUN Command 

When you start a system job (by typing SRUN filnam), the default device 
on which the monitor looks for the program file is SY:. (You can run system 
jobs under an FB or XM monitor that includes the system job feature.) If 
you have a special application, you can change this default to any three- 
character device name. 

In this customization, monitr.SYS is the name of the monitor file that you 
want to modify, ..SRDK is the value of that symbol from the monitor link 
map, and nnn is the new default device name. 

. RUN SIPP® 
» monit r.SYSdl) 
Base? 0® 
Offset? ..SRDKSD 

Base Offset Old New 
000000 ,,SRDK 015270 



000000 ..SRDK <SY > iRnnn® 

000000 ..SRDK + 2 <AW1> (Ctrl/y ) (Rgf) 



* (CTRL/Cl 



D.5 Changing the Default File Type for the SRUN Command 

When you start a system job, the default file type for the program file is 
.REL. If you have a special application, you can change this default to any 
three-character file type. 

In this custom-ization, monitr.SYS is the name of the monitor file that you 
want to modify, ..SRUX is the value of that symbol from the monitor link 
map, and nnn is the new default file type. 



.RUN SIPP® 








* monit r.SYSd!) 








Base? 


0® 








Offset? 


. .SRUKdl) 






Base 




Offset 


Old 


New 


000000 




, ,SRUX 


075273 


iR® 


000000 




. .SRUK 


<REL> 


; R n n n 


000000 




. .SRUX+2 


< X X X > 


(CTRL/Y )(R 



» (CTRL' C) 
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D.6 Assigning a Remote Line as the Console Terminal 

You can customize your FB and XM monitors to allow a terminal connected 
via a dial-up line to be used as the console terminal. The multiterminal 
software will answer the line when called (provided appropriate modem 
hardware is in place) and connect the remote terminal to the system as the 
console terminal. 

In this customization, monitr.SYS is the name of the multiterminal moni- 
tor file that you wish to modify, and ..CRMT is the value of that symbol 
from the monitor link map. 

.RUN SIPPEE) 
*iiioriit r.SYSda) 
Base? OSm 

Offset? , .CRMTdl) 

Base Offset Old New? 
000000 ..CRMT 020000 OdS) 



000000 ..CRMT + 2 xxxxxx (ctbl/y 



* ICTRL'C) 



D.7 Changing the Device Name of the UCL File 

If you selected user command linkage (UCL) support when you performed 
your system generation, you can customize the monitor to change the de- 
vice nam.e from, where the UCL file is run (by default SY:). Use the follow- 
ing alteration to change the contents of location ..UCLF to the RAD50 
device name. 

In the customization, monitr.SYS is the name of the monitor file that you 
wish to modify, ..UCLF is the value of that symbol from the monitor link 
map, and yyy is the name of the device from which the UCL file will be run. 



. RUN SlPPgS) 






# monitr.SYBd!) 






Base'? OEl) 






Offset? ..UCLFdl) 






Base Offset 


Old 


iRyy/Oi 

(CTRL/Y )IRET1 


000000 ..UCLF 


X X X XX X 


000000 ,.UCLF+2 


X X X XX X 


* (frRL/O 
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INDEX 



/ALLOCATE option, 3-7 
Altering system generation 

command files, 2-2 
Answer file 
creation, 1-15 
required with SPR, 3-12 
use of previously created, 1-14 
Assembling diskette files, 3-7 
Assembling monitor and device 

handlers, 3-7 
Asynchronous terminal status, 1-5, 

1-18 
Automatic installation, 2-8 
Automatic system build, 1-9 

BA.MAC, 1-10 

Banner page support, 1-28 

BATCH, 1-5 

Batch support, 1-25 

Baud rates, 1-35 

BIN:, 1-9 

Binary output device, 1-11, 1-37 

Block-replaceable device, 1-12, 

2-2 
Bootstrap routine's automatic 

installation capability, 2-8 
BSTRAP.MAC, 1-10 
Building device handlers, 1-38 
Building handlers separately, 2-8 
Building monitors, 1-38 

Changing dialog responses, 2-2 
Changing responses to dialog, 
1-35 



Conditional files 
retaining source files after 
build, 1-38 

CR.MAC, 1-10 

CSR addresses 
DLll lines, 1-33 
First DZ multiplexer, 1-34 
Local DLll interfaces, 1-33 
parallel printer, 1-29 
printer nonstandard, 1-29 
Remote DLll interfaces, 1-33 
RX02 diskette, 1-27 
serial line printer, 1-30 
VT11A^T60, 1-31 
XL handler, 1-30 

CT.MAC, 1-10 

CTRL/C, 2-1, 3-2 

CTRL/0, 2-2, 3-2 

DD.MAC, 1-10 

Default SYSGEN responses, 2-1 

Deleting .OBJ files, 1-9 

Device 

binary output, 1-11 

block-replaceable, 1-12, 2-2 

map output, 1-12 

source input, 1-10 

system, 1-10 
Device handlers 

assembling and linking, 2-2 

associated with specific 
monitors, D-2 

building, 1-38 

changing file name suffix, D-2 



Index— 1 



installing generated handlers, 

D-1 
Device I/O timeout, 1-5 
Device options, 1-26 
addresses of magtape units, 

1-29 
banner page support, 1-28 
changing, 1-35 
GSR addresses, 1-27 
disk platters on RFll subsystem, 

1-27 
extra device slots, 1-31 
file-structured magtape handler, 

1-28 
MSCP port support, 1-28 

how many supported, 1-28 
number of magtape units 

supported, 1-28 
number of RL01/RL02 units 

supported, 1-28 
parallel printer CSR address, 

1-29 
Professional 300 printer port 

support, 1-30 
RJS03 rather than RJS04 support, 

1-27 
RPR02 rather than RPR02/RP03 

support, 1-28 
RX02 double-density only 

support, 1-27 
support for second device 

controller, 1-26 
support for user-supplied 

device handlers, 1-30 
vector addresses, 1-27 
Device selection, 1-37 
Device timeout support, 1-17 
Devices 
also see Device options 
Adding support for a device, 

1-36 
asterisk in list, 1-26 
list of valid, 1-26 
peripheral, 1-4 
Removing support for, 1-36 
DEVTBL.MAC, 1-30 
Dial-up line as console terminal, 

D-3 
Disable .FETCH request, 1-5 
Disk platters on RFll subsystem, 

1-27 
Diskette 
RX01/RX02, 3-1 
RX50, 1-10, 1-12, 1-26 
working system, 3-1 



DL.MAC, 1-10 

DLll lines, CSR address for, 1-33 

DLll lines, vector address for, 

1-33 
DLll-W, 1-32 
DM.MAC, 1-10 

Double-density only RX02, 1-5 
Double-density only support, 1-27 
DP.MAC, 1-10 
DS.MAC, 1-10 
DT.MAC, 1-10 
DU.MAC, 1-10 
DW.MAC, 1-10 
DX.MAC, 1-10 
DY.MAC, 1-10 
DZ lines supported 

baud rates, 1-35 

Number of local lines, 1-34 

Number of remote lines, 1-34 
DZ multiplexer support 

Number of, 1-34 
DZ.MAC, 1-10 

DZll multiplexer support, 1-34 
DZll up to 9600 baud, 1-5 
DZll/DZVll multiplexer support, 
1-34 

EDTGBL 

required for assemblies, 3-8 
EDTGBL.MAC, 1-10 
EL.MAC, 1-10 
ELCOPY.MAC, 1-10 
ELINIT.MAC, 1-10 
ELTASK.MAC, 1-11 
Error logging, 1-5, 1-25 

number of units supported, 1-25 
Error messages for SYSGEN, 2-2, 

3-2 
Errors 

system build, 2-4 
ERRTXT.MAC, 1-11 
Extended memory monitor, see XM 

monitor 
Extra device slots, 1-5, 1-31 

FB monitor, 1-16 

duplicating standard, A-1 
FB.MAC, 1-11 
.FETCH request, 1-20 
Files created by SYSGEN, 3-2 
Floating point support, 1-23 
Foreground/background monitor, 

see FB monitor 
Free space, consolidating, 2-3, 2-6 
FSM.MAC, 1-11 



Index-2 



Global SCCA, 1-5, U18 
Graphics options, 1-31 

GSR address for VT11/VT60, 1-31 

Vector address for VT11/VT60, 
1-31 

VT11/VT60 support, 1-31 

VT60 support, 1-31 

Handler file-name, changing the 

suffix, D-2 
High-speed ring buffer, 1-5, 1-20 
50 Hz clock, 1-22 

Identifying diskettes (volume ID), 

3-5 
Identifying specially generated 

monitors, 2-5, 3-11 
IND.SAV, 1-2 
IND.SAV, running, 2-1 
Indirect command file 
SYSGEN.BLD, 2-4 
to build device handlers, 2-7 
to build monitor, 2-6 
Indirect command file, start-up, 

1-23 
Indirect command files, 1-8, 1-13 
editing, 2-3 

retaining after build, 1-38 
to build diskette system, 3-3 
to build system, 2-3 
Initializing diskettes, 3-5 
Input ring buffer size, 1-19 
Installing additional device 

handlers, 2-8 
Installing generated system, 3-11 
Invoking system generation 
command file, 2-4 

Keeping monitor small, 2-8 
Keyboard monitor command subsets, 

1-6 
Keyboard monitor commands, 1-20 
KMON overlays, 3-6 
KMON.MAC, 1-11 
KMOVLY.MAC, 1-11, 3-6 
KWll-P programmable clock, 1-23 

LD.MAC, 1-11 
Link map, 3-10 

suppression of, 2-2 
Link maps 

on map output device, 1-12 

required with SPR, 3-12 

saved on disk, 1-12 

suppression, 1-12 



Linking files in diskette system, 

3-10 
Linking monitor and device 

handlers, 3-7 
Local DLll lines supported, 1-32 
Logical assignments, 1-9 
Logical device, 3-7 
LP.MAC, 1-11 
LS.MAC, 1-11 

MACRO, 3-10 
MAGRO work file, 3-7 
Magtape 
file-structured handler, 1-28 
number of units supported, 1-28 
unit addresses, 1-29 
Manual system build, 1-13 
Map output device, 1-12, 1-37, 

2-2 
MAP:, 1-9 
Mass storage 

optimizing, 1-9, 2-3 
Memory parity, 1-6 
Memory parity support, 1-24 
Monitor 

keeping it small, 2-8 
Monitor options, 1-16 
asynchronous terminal status, 

1-18 
batch support, 1-25 
changing, 1-35 
device timeout support, 1-17 
error logging, 1-25 
number of units supported, 
1-25 
error message on system I/O 

errors, 1-17 
.FETCH request, 1-20 
floating point support, 1-23 
Global SCCA support, 1-18 
high-speed ring buffer support, 

1-20 
50 Hz clock, 1-22 
input ring buffer size, 1-19 
keyboard monitor commands, 1-20, 
1-21 
language subset, 1-22 
minimal subset, 1-22 
utility subset, 1-21 
memory parity support, 1-24 
month and year date rollover, 

1-20 
multiterminal support, 1-18 
multiterminal timeout support, 
1-19 
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output ring buffer size, 1-19 

power failure message, 1—24 

programmable clock as system 
clock, 1-23 

save/set main-line PC & PS, 
1-18 

SJ timer support, 1-16 

.SPCPS request, 1-18 

start-up indirect command file, 
1-23 

system job support, 1-17 

user command linkage, 1-20 
Monitor services, 1-7 
Monitor type, 1-15 
Monitors 

assembling and linking, 2-2 

associating handlers with 
specific monitor, D-2 

building, 1-38 

customizations, D-1 

duplicating standard, A-1 
Month and year date rollover, 

1-20 
Month and year rollover, 1-6 
MSCP port support, 1-28 
MTTEMT.MAC, 1-11 
MTTINT.MAC, 1-11 
Multiplexer support, 1-34, 1-35 
Multiterminal support, 1-6, 1-18 

suppressing polling routines, 
D-2 

TRMTBL.MAC required, 1-10 
Multiterminal system 

answers to create, B-1 
Multiterminal timeout, 1-6 
Multiterminal timeout support, 
1-19 

NL.MAC, 1-11 

Object files, 3-6 

on binary output device, 1-11 
Object modules, retaining system 

OBJs, 1-38 
Output ring buffer size, 1-19 

PC.MAC, 1-11 

PD.MAC, 1-11 

Peripheral devices, 1-4 

Polling routine suppression, D-2 

Power failure message, 1-24 

Printer 

nonstandard addresses, 1-29 

parallel, 1-29 



GSR address, 1-29 
vector address, 1-29 
serial 
CSR address, 1-30 
vector address, 1-30 
Professional 300 series 

printer port support, 1-30 
Programmable clock as system 

clock, 1-6, 1-23 
Programmed request 
.SPCPS, 1-6 

Remote DLll lines supported, 1-33 
Removing device support, 1-36 
Responses 
changing dialog, 2-2, 3-2 
inappropriate SYSGEN, 3-2 
Retaining work files, 1-38 
RF.MAC, 1-11 
Ring buffer size, 1-6 
RJS03 rather than RJS04 support, 

1-27 
RK.MAC, 1-11 
RL01/RL02, number of units 

• supported, 1-28 
RMONFB.MAC, 1-11 
RMONSJ.MAC, 1-11 
RMONxx.MAC, 3-8 
RPR02 rather than RPR02/RP03 

support, 1-28 
RT-11 conditionals, C-1 
.RUN IND.SAV SYSGEN.COM, 2-1 
Running SYSGEN.COM, 3-1 
RX01/RX02 diskette, 3-1 
RX02 double-density only support, 

1-27 

Save/set main-line PC & PS, 1-18 

Second controller, 1-6 

Second device controller support, 

1-26 
Serial printer vector address, 

1-30 
.SFPA programmed request, 1-24 
Single-job monitor, see SJ 

monitor 
SJ monitor, 1-16 

duplicating standard, A-1 
SJ timer support, 1-6, 1-16 
SJ.MAC, 1-11 
Software Performance report, see 

SPR 
Source files, 2-2 
changing device, 2-3 
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deleting, 2-6 

required for system build, 1-10 
Source input device, 1-10, 1-37 
SP.MAC, 1-11 

.SPCPS programmed request, 1-6 
SPR, 1-12, 2-7, 3-12 
for specially generated monitor, 
3-11 
SRC:, 1-9 
SRUN command 
changing default device, D-3 
changing default file type, D-3 
Start-up indirect command file, 

1-23 
Suppressing link maps, 1-12, 2-2 
.SYG file type, 2-7 

renaming, 2-5, 2-7 
.SYG master files, 3-11 
SYSGEN responses, inappropriate, 

2-2, 3-2 
SYSGEN.ANS, 3-3 
SYSGEN.BLD, 1-38, 2-2, 2-3, 2-4, 

3-2 
SYSGEN.CND, 1-10, 1-11, 2-3, 3-2 

required for assemblies, 3-8 
SYSGEN.COM, 1-2, 2-1, 3-1 
SYSGEN.DEV, 2-2, 2-3, 2-6, 2-7, 

3-3 
SYSGEN.MON, 2-2, 2-3, 2-6, 3-3 
SYSGEN.TBL, 1-10, 1-11, 2-3, 3-2 
System build 
automatic, 1-9 
binary output device, 1-11 
creating diskette system, 3-5 
default device requirements, 

1-10 
diskette 
assembling and linking, 3-7 
assembling files, 3-7 
COPY commands, 3-7 
errors, 3-11 
linking files, 3-10 
diskette contents, -3-6 
fourth diskette, 3-6 
second diskette, 3-6 
system diskette, 3-6 
third diskette, 3-6 
diskette working system, 3-1 
errors, 2-4 
files to retain, 2-7 
free storage requirements, 1-11 
indirect command files, 1-8, 

1-13, 2-3, 3-3 
manual, 1-13 



map output device, 1-12 

procedure, 1-8 

procedure for diskette system, 

3-3 
required free blocks, 1-10 
required source files, 1-10 
source input device, 1-10 
SYSGEN dialog, 1-37 
binary output device, 1-37 
build entire system, 1-38 
build just monitors, 1-38 
device and unit number, 1-37 
map output device, 1-37 
retaining system OBJs, 1-38 
retaining work files, 1-38 
using SYSGEN.BLD to perform, 

2-3 
using SYSGEN.MON and SYSGEN.DEV, 
2-6 
System conditionals, C-1 
changing, 1-37 
defining, 1-37 
in SYSGEN dialog, 1-25 
individual keyboard monitor 

commands, C-5 
user defined, 1-8 
System device, 1-10 
contents, building disk system, 

2-1 
contents, building diskette 
system, 3-5 
System diskette, 3-6 
System generation 
altering command files, 2-2 
building one monitor at a time, 

3-1 
Changing responses to dialog, 

1-35 
cleanup, 1-37 
default answers, 1-13 
dialog, 1-13 
device options, 1-26 
monitor options, 1-16 
monitor questions, 1-15 
introduction to, 1-14 
on RX01/RX02 diskette system, 

1-13 
performing on small system, 3-1 
procedure on disk system, 2-1 
summary of questions, A-5 
terminating, 2-1, 3-2 
System I/O error message, 1-6 
System job support, 1-7, 1-17 
System source files, 1-10 
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Terminal interface options 
baud rates of DZ lines, 1-35 
CSR address for DLll lines, 

1-33 
CSR addresses 

First DZ multiplexer, 1-34 
DZll multiplexer support, 1-34 
DZll/DZVll multiplexer support, 1- 
Introduction, 1-32 
Local DLll lines supported, 

1-32 
Number of DZ multiplexers 

supported, 1-34 
Number of local DZ lines 

supported, 1-34 
Number of remote DZ lines 

supported, 1-34 
Remote DLll lines supported, 

1-33 
Vector address for DLll lines, 

1-33 
Vector addresses 
First DZ multiplexer, 1-34 
Terminating SYSGEN, 2-1 
TJ.MAC, 1-11 
TM.MAC, 1-11 
TRMTBL.MAC, 1-10, 1-11 
TS.MAC, 1-11 
TT.MAC, 1-11 



Using SYSGEN.MON and SYSGEN.DEV 

to build system, 2-6 
USR.MAC, 1-11, 3-8 

Vector addresses 

DLll lines, 1-33 

First DZ multiplexer, 1-34 
34 Local DLll interfaces, 1-33 

magtape units, 1-29 

parallel printer, 1-29 

printer nonstandard, 1-29 

Remote DLll interfaces, 1-33 

RX01,RX02,DECtape II, 1-27 

serial line printer, 1-30 

VT11A^T60, 1-31 

XL handler, 1-30 
VM.MAC, 1-11 
Volume ID, 3-5 
VT11A^T60 support, 1-31 
VT11/VT60,CSR address for, 1-31 
VTll/VT60,Vector address for, 

1-31 
VT60 support, 1-31 

WF:, 3-7 
Work file 

MACRO, 3-7 
Work files, retaining, 1-38 



UCL 

see user command linkage 
User command linkage, 1-7, 1-20 
changing default device, D-4 
User-generated monitor identifier 

(S), 3-11 
User-supplied device handlers, 

support for, 1-30 
Using SYSGEN.BLD to build system, 2-3 



XC.MAC, 1-11 

XL handler 
setting CSR address, 1-30 
setting vector address, 1-30 

XL.MAC, 1-11 

XM monitor, 1-16 
duplicating standard, A-3 

XM.MAC, 1-11 

XMSUBS.MAC, 1-11 
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ADDITIONAL DOCUMENTATION 



From 



Call 



Write 



Chicago 



312-640-5612 

8:15 AM to 5:00 pm CT 



Digital Equipment Corporation 
Accessories & Supplies Center 
1050 East Remington Road 
Schaumburg, IL 60195 



San Francisco 
Alaska, Hawaii 



408-734-4915 

8:15 am to 5:00 pm PT 

603-884-6660 

8:30 am to 6:00 pm ET 

or 408-734-4915 

8:15 am to 5:00 p M PT 



Digital Equipment Corporation 
Accessories & Supplies Center 
632 Caribbean Drive 
Sunnyvale, CA 94086 



New Hampshire 

Rest of U.S.A., 
Puerto Rico* 



603-884-6660 

8:30 AM to 6:00 p M ET 

1-800-258-1710 

8:30 AM to 6:00 pm ET 



Digital Equipment Corporation 
Accessories & Supplies Center 
P.O. Box CS2008 
Nashua, NH 03061 



•Prepaid orders from Puerto Rico must be placed with the local DIGITAL subsidiary (call 809-754-7575) 



Canada 
British Columbia 

Ottawa-Hull 

Elsewhere 



1-800-267-6146 
8:00 AM to 5:00 p M ET 

613-234-7726 

8:00 AM to 5:00 p m ET 

112-800-267-6146 

8:00 AM to 5:00 pm ET 



Digital Equipment of Canada Ltd 
940 Belfast Road 
Ottawa, Ontario K1G 4C2 
Attn: A&SG Business iVlanager 



Elsewhere 



Digital Equipment Corporation 
A&SG Business Manager* 



*c.'o DIGITAL'S local subsidiary or approved distributor 
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READER'S COMMENTS 



NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 
company's discretion. If you require a written reply and are eligible to receive one under Software 
Performance Report (SPR) service, submit your comments on an SPR form. 



Did you find this manual understandable, usable, and well organized? Please make suggestions for improvement. 



Did you find errors in this manual? If so, specify the error and the page number. 



Please indicate the type of user/reader that you most nearly represent. 

— Assembly language programmer 

— Higher-level language programmer 

— Occasional programmer (experienced) 

— User with little programming experience 

— Student programmer 

— Other (please specify) 



Name Date . 



Organization Telephone . 

Street 



City State Zip Code . 



or Country 
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